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I NTRQDUCT I  ON 


I  . 


INGRES  is  a  m i n i computer -based  database  management 
system  (DBMS)  developed  and  distributed  by  Relational 
Technologies  Incorporated  ( RT I ) .  This  work  assumes  that  the 
reader  is  familiar  with  the  various  classes  of  data  bases 
and  therefore,  without  any  further  explanation  of  the 
various  database  classifications  [Ref.  11,  it  is  simply 
stated  that  INGRES  is  classified  as  a  relational  database  l. 
The  noteworthy  feature  of  INGRES  is  its  visually  oriented 
user  interface.  Rather  than  presenting  the  user  with  the 
"normal"  text  oriented  display,  INGRES  presents  the  user 
with  a  form  with  which  to  insert  (append)  data  into  the  data 
base  or  with  which  to  extract  (query)  data  from  the  data 
base.  As  has  been  seen  from  the  user  interface  research 
done  by  XEROX  PARC,  Apple  Corporation’s  Macintosh  Division, 
and  others,  there  is  an  increasing  trend  toward  more 
visually  oriented  user  interfaces.  Chernicoff  [Ref.  2] 
explains  this  trend  as  a  reflection  of  the  philosophy  at  the 
Macintosh  Division  that  the  user  interface  should  be  one 
which  presents  the  user  with  a  "metaphor  for  life”  hence  the 


1  As  opposed  to  a  hierarchical,  network,  or  other  type 
of  database. 
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Macintosh  "desk  top"  with  its  associated  icons  for  trash, 
files,  documents,  and  so  forth.  Although  not  as  elaborate 
as  the  Macintosh  interface,  INGRES  does  present  the  database 
user  with  its  own  "metaphor  for  database  life"  and  its 
associated  icon  is  the  form.  As  explained  by  RT I  [Ref.  3], 
"A  form  is  similar  to  a  paper  form  that  you  fill  in.  A 
computer  form  appears  on  the  CRT  of  the  terminal,  and  it 
provides  blank  spaces  in  which  the  computer  displays 
information  or  you  enter  information."  In  addition  to 
providing  the  user  with  the  form  for  data  entry  and 
manipulation,  INGRES  also  provides  the  "report"  and  the 
"graph"  for  the  formatting  of  data  output  into  a  variety  of 
formats.  The  INGRES  DBMS  is  composed  of  several  subsystems 
which  will  be  described  briefly  in  the  remainder  of  this 
chapter.  The  purpose  of  this  thesis  is  to  examine  and 
critique  the  INGRES  subsystem  called  App 1 i cat i ons-By-Forms 


( ABF ) ,  which 

purportedly  permits 

the 

user  to 

build 

independent 

database 

app 1 i ca t ions 

programs  through 

the 

man i pu 1  a t i on 

of  screen 

based  forms. 

The 

examination 

and 

critique  of  the  INGRES  subsystem  App 1 i cat i ons-By-Forms  (ABF) 
will  be  accomplished  by  the  development  of  an  independent 
database  applications  program.  The  development  project  is 
described  in  chapter  two  and  the  results  are  presented  in 
Chapter  III. 
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A.  INGRES/MENU 

1NGRES/MENU  is  best  described  as  the  top  or  executive 
level  of  the  INGRES  system.  The  user  is  presented  with  a 
form  (Figure  1)  from  which  he  may  access  any  of  the  various 
INGRES  subsystems.  INGRES  is  particularly  easy  to  use  in 
this  mode  due  to  the  abundance  of  on-line  help  facilities  at 
all  levels,  beginning  with  this  topmost  level.  Some  of  the 
fundamental  knowledge  the  user  must  know  is  that  a  screen  is 
actually  composed  of  two  entities,  a  form  and  a  menu.  This 
conglomerate  is  called  a  frame.  The  user  utilizes  cursor 
control  keys  to  move  the  cursor  to  an  item  on  the  form  and 


then  presses 

the 

"menu"  key 

to  select 

an  operation 

to 

perform  from 

the 

menu  at  the 

bottom  of 

the  screen. 

The 

operation  is  specified  by  typing  the  first  one  or  two  unique 
characters  of  the  command’s  name  followed  by  the  "return”  or 
"enter”  key.  The  menu  key  is  generally  the  "escape"  key  on 
most  terminals.  This  method  of  selecting  an  item  and  an 
operation  to  perform  on  it  is  consistent  throughout  INGRES. 

In  Figure  1,  the  menu  is  the  line  that  reads,  "Go 
History  CommandMode  DBswitch  Shell  Help  Quit".  The 
remainder  of  the  screen  is  the  form  from  which  items  are 
chosen  by  placing  the  cursor  on  the  same  line  as  the  item 
and  then  depressing  the  menu  key  to  select  an  appropriate 
act  ion. 

Figure  1  illustrates  all  of  the  subsystems  that  may  be 
chosen  from  the  executive  level.  Many  of  the  subsystems 
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form  related  groups  by  virtue  of  the  similarity  of  their 


ef  f ects . 

For  instance,  "REPORT",  "RBF" ,  and  "SREPORT"  are 

a  1  1  part 

of  the  INGRES  system  that  pertains  to  the 

formatting 

of  reports  for  data  output.  They  will  be 

described  briefly  below.  Similarly,  "Query”,  "QBF",  and 
"QUEL"  are  all  methods  of  formulating  a  command  to  retrieve 
user  specified  data  from  the  database. 

B.  INGRES/QUERY:  QUERY -BY -FORMS 


INGRES 

Query-By-Forms  (QBF)  facilitates  routine 

oper at i ons 

on  a  database.  These  routine  operations  are*. 

Query 

-  the  retrieval  of  data  from  the  database. 

Append 

-  the  adding  of  data  to  the  database. 

Update 

-  the  changing,  usually  for  the  purpose  of 
correction,  data  in  the  database. 

Delete 

-  the  removal  of  data  from  the  database. 

These  data  manipulations  are  accomplished  on  INGRES 
forms.  There  are  two  methods  of  obtaining  a  form  on  which 
to  operate.  First,  since  relational  systems  are  generally 
thought  of  as  storing  data  in  tables,  INGRES  can  and  does 
use  the  information  from  the  table  associated  with  the 
particular  database  and  query  to  construct  a  default  form. 
The  second  option  is  for  the  user  to  create  a  customized 
form.  There  are  several  methods  for  creating  customized 
forms,  but  the  simplest  method  is  to  utilize  INGRES/FORMS: 
V i sua 1 -Forms -Ed i tor  (VIFRED),  discussed  below.  The  default 
forms  are  only  satisfactory  if  the  query  is  relatively 
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simple  (i.e.,  has  few  elements)  or  no  one  other  than  the 
creating  user  will  be  seeing  the  form. 

Additionally,  QBF  includes  a  ’’Join  Definition”  phase 
which  enables  the  user  to  define  joins  between  tables  in  a 
relational  database,  selecting  only  those  elements  desired 
for  display. 

Figure  2  illustrates  the  opening  screen  of  QBF  when 
called  from  the  screen  of  Figure  1  (INGRES  MENU).  If  the 
user  simply  orders  INGRES  to  proceed  at  this  point,  by 
issuing  the  "Go"  command  without  entering  a  form  name,  then 
the  screen  appears  as  in  Figure  3.  This  is  the  top  level 
screen  of  the  INGRES/QBF  subsystem.  All  of  the  INGRES 
subsystems  may  be  entered  directly  from  outside  the  INGRES 
system,  i.e.,  directly  from  the  UNIX  operating  system  shell, 
by  typing  the  appropriate  system  shell  level  command.  If 
QBF  is  entered  in  this  fashion  then  Figure  3  is  the  first 
screen  seen  by  the  user. 

Queries  may  be  made  based  on  either  a  previously  defined 
form  which  has  been  assigned  a  QBF  name,  a  table  in  the 
relation,  or  a  defined  join  definition  by  issuing  the 
commands  "QBFname",  "Table",  or  "JoinDef",  respectively. 
These  commands  are  executed  from  the  command  menu  of  Figure 
3. 
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C.  INGRES /FORMS :  V 1 SUAL-FORMS -ED  1  TOR  ( V  I  FRED ) 

V I  FRED  is  the  INGRES  utility  system  which  allows  the 
user  to  either  customize  the  default  forms  provided  by  QBF 
and  other  INGRES  subsystems,  or  build  a  form  completely  from 
scratch.  There  are  a  few  terms  which  require  explanation. 
Any  form  in  INGRES  is  constructed  of  trim  elements  and 
fields.  Trim  is  text  which  appears  on  the  screen  in  the 
form  of  explanatory  notes,  instructions,  etc.  Fields  are 
those  portions  of  the  screen  which  either  display  or  receive 
data.  A  field  has  two  components,  a  title,  which  is  also 
considered  to  be  trim,  and  a  data  window  which  either 
displays  or  receives  data.  As  with  most  common  computer 
languages,  data  elements  have  types  such  as  character, 
floating  point,  and  integer.  The  capabilities  of  VIFRED  are 
primarily  the  following: 

-  Editing  the  textual  parts  of  a  form,  including  trim 
elements  and  field  names. 

-  Moving  elements,  trim  or  field,  from  one  place  to 
another  on  a  form.  The  title  (trim)  and  data  window  can 
be  moved  separately. 

-  Add  new  trim  elements  and  fields. 

-  Delete  existing  trim  elements  and  fields. 

-  Edit  a  field's  attributes. 

The  above  operations  are  also  consistent  with  and 
comparable  to  those  in  the  INGRES  REPORT  subsystem.  Figure 
4  illustrates  the  opening  screen  of  QBF  when  called  from  the 
screen  of  Figure  1  (INGRES  MENU).  If  the  user  simply  orders 
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INGRES  to  proceed  at  this  point,  by  issuing  the  "Go"  command 
without  entering  a  form  name,  then  the  screen  appears  as  in 
Figure  5.  This  is  the  top  level  screen  of  the  INGRES  V I  FRED 
subsystem.  If  V I  FRED  is  entered  directly  from  the  UNIX 
operating  system  then  Figure  5  is  the  first  screen  seen  by 
the  user. 

D.  INGRES/REPORTS :  REPORT- BY- FORMS  ( RBF ) 

The  RBF  subsystem  is  the  complement  to  the  QBF 
subsystem.  RBF  will  provide  a  default  format  for  data 
output  in  a  fashion  similar  to  that  of  QBF.  The  user  also 
has  the  option  of  editing  the  appearance  and  content  of  the 
default  report  forms  or  constructing  one  from  scratch,  also 
similar  to  the  capability  of  the  QBF  subsystem.  RBF  has  a 
visual  forms  oriented  user  interface.  RT 1  [Ref.  3,  pg  4-12] 
lists  the  following  as  the  characteristics  of  a  report  that 
may  be  modified  using  INGRES  RBF: 

-  content  and  placement  of  the  report’s  title 

-  content  and  placement  of  the  column  headings 

-  display  formats  for  data  items  in  columns 

-  page  length  (number  of  lines  per  report  page) 

-  under  1 ining 

-  how  rows  of  data  are  sorted  in  the  report 

RBF  is  only  one  means  of  formatting  and  producing 
database  reports  using  INGRES.  Another  is  the  REPORT- 

WRITER.  RT  I  describes  the  REPORT-WR 1  TER  as  ".  .  .  an 
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extensive  program  that  provides  maximum  flexibility  in 
specifying  and  formatting  data  for  reports. "  This  increased 
flexibility  however,  comes  at  the  expense  of  the  visual, 
forms  oriented  user  interface.  In  order  to  take  advantage 
of  the  increased  flexibility  available  through  the  INGRES 
REPORT- WR 1  TER ,  the  user  must  learn  INGRES’S  own  Report 
Specification  Language  (RSL).  RBF  does  provide  a  generous 
subset  of  the  report  formatting  capabilities  of  INGRES 
REPORT- WR 1  TER .  Figure  6  illustrates  the  opening  screen  of 
QBF  when  called  from  the  screen  of  Figure  1  (INGRES  MENU). 
If  the  user  simply  orders  INGRES  to  proceed  at  this  point, 
by  issuing  the  "Go"  command  without  entering  a  form  name, 
then  the  screen  appears  as  in  Figure  7.  This  is  the  top 
level  screen  of  the  INGRES  RBF  subsystem.  If  RBF  is  entered 
directly  from  the  UNIX  operating  system  then  Figure  7  is  the 
first  screen  seen  by  the  user. 

E.  INGRES/GRAPHICS :  GRAPH-BY-FORMS  ( GBF ) 

INGRES  GBF  is  a  forms-based  graph  definition  facility. 
It  provides  the  user  with  the  capability  to  format  data 
output  from  a  database  into  the  form  of  graphs  and  charts 
instead  of,  or  in  addition  to,  tabulated  report  format. 
INGRES  GBF  also  provides  the  user  with  some  editing 
capabilities  with  respect  to  the  final  form  and  appearance 
of  the  various  graphs  and  charts.  RT 1  [Ref.  3,  pg  4-14] 
indicates  the  user  determinable  features  of  GBF  to  be  : 
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-  the  data  to  be  graphed 

-  the  type  of  graph  to  be  used  (e.g.,  bar  chart,  pie 
chart,  scatter  plot  or  line  chart) 

-  line  types,  dot  types,  crosshatch  patterns 

-  content  and  placement  of  the  graph’s  title 

-  content  and  placement  of  the  graph’s  legend  (optional) 

GBF  is  not  installed  at  all  INGRES  installations  and  is 

not  installed  on  the  Naval  Postgraduate  School  Computer 
Science  Department’s  UNIX/INGRES  system. 

F.  INGRES/APPLICATIONS:  APPL 1  CAT  1 ONS -BY -FORMS  (ABF) 

INGRES  Appl i cat i ons -By-Forms  (ABF)  enables  the 

1 NGRES/database  applications  programmer  to  develop  and 
compile  database  applications  programs  that  will  run 
independently  of  the  INGRES  system.  RT1  insists  that  ABF 
can  be  used  to  develop  an  applications  program  without 
requiring  the  developer  to  know  a  programming  language.  The 
database  program  development  can  be  accomplished  solely  via 
the  INGRES  forms  based  visual  interface.  There  are  however, 

limitations  to  the  level  of  sophistication  or  intricacy  of 

an  applications  program  developed  under  this  interface. 
INGRES  has  provided  an  extension  in  the  form  of  a  small 
Operations  Specification  Language  (OSL)  for  those  developers 
who  desire  to  "write”  programs  of  greater  sophistication 
than  may  be  developed  through  the  forms  interface  alone. 
INGRES  also  provides  for  the  incorporation  of  modules  and 
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procedures  written  in  more  conventional  programming 
languages  such  as  COBOL,  FORTRAN,  PASCAL,  C,  and  BASIC. 

An  application  program  developed  exclusively  through  the 
INGRES  forms  interface  tends  to  take  the  form  of  sequences 
of  INGRES  queries  and  system  commands.  This  limits  the 
flexibility  of  such  a  development.  In  order  to  realize  a 
higher  degree  of  flexibility  in  program  performance  it  is 
necessary  to  learn  the  INGRES  OSL.  This  small  language  is 
not  difficult  to  learn,  consisting  of  approximately  100 
words  or  less.  The  use  of  OSL  is  particularly  required  if 
user  defined  forms,  frames  and  menus  are  to  be  used  in  the 
application.  The  degree  to  which  inclusion  of  modules 
written  in  conventional  languages  enhances  applications 
program  development  depends  on  the  proficiency  of  the 
individual  programmer. 

Figure  8  illustrates  the  opening  screen  of  ABF  when 
called  from  the  screen  of  Figure  1  (INGRES  MENU).  If  the 
user  simply  orders  INGRES  to  proceed  at  this  point,  by 
issuing  the  "Go"  command  without  entering  a  form  name  2, 

then  the  screen  appears  as  in  Figure  9.  This  is  the  top 
level  screen  of  the  INGRES/QBF  subsystem.  If  ABF  is  entered 
directly  from  the  UNIX  operating  system  shell,  then  Figure  9 
is  the  first  screen  seen  by  the  user. 


2  Although  a  form  name  is  optional,  INGRES  will  not 
proceed  without  an  application  program  name. 
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II.  DEVELOPMENT  PROJECT  DESCRIPTION 


A.  PROJECT  OBJECTIVES 

The  objectives  of  the  development  project  were  two-fold. 
First,  it  was  necessary  to  exercise  the  INGRES  Application- 
By-Forms  (ABF)  subsystem  in  order  to  make  a  fair,  objective 
assessment  of  its  capabilities  and  shortcomings  in  building 
an  application  program.  Therefore,  the  first  objective  was 
ob ject i vi ty . 


Second  1 y 

,  the 

project 

itself 

needed 

a 

database  related 

app 1  i ca  t ion. 

1 1 

was  determined 

that 

a 

b i b 1  i og  raph i ca 1 

search  and 

report 

bui 1 der 

would 

serve 

the 

purpose  of  a 

database- type  application.  This  would  also  slightly  extend 
the  objective  served  by  modestly  exercising  the  INGRES 
Report-By-Forms  (RBF)  subsystem  as  well. 

B.  PROJECT  DESCRIPTION 

The  development  project  assumed  the  form  of  a 
bibliographical  search  and  report  builder  and  was  called 
’’references”.  The  program  consists  of  a  number  of  ’’forms” 
defined  under  the  INGRES  Visual  Forms  Editor  (V1FRED). 
INGRES  ’’forms”  are  subsequently  combined  with  ’’menus”  to 
form  ’’frames”.  A  frame  then  equates  to  what  a  program  user 
sees  on  the  terminal  screen.  The  menus  are  built  with  code 
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segments  using  INGRES  ABF’s  Operation  Specification  Language 
(OSL)  and  INGRES’S  version  of  Query  Language  (QUEL). 

The  specific  functions  performed  by  the  program 
’’references"  (the  name  is  not  capitalized  in  deference  to 
UNIX  operating  system  convention)  are  best  presented  by 
"walking”  through  an  execution  of  the  program  and  addressing 
the  various  program  functions  as  they  arise.  RTI  has 

adopted  the  convention  of  calling  the  <Esc>  key  the  "MENU" 
key,  due  to  its  RTI-imposed  function  of  placing  the  cursor 
in  the  menu  line  at  the  bottom  of  the  terminal  screen.  The 
same  convention  will  be  followed  throughout  the  remainder  of 
this  thes i s . 

1 .  Topf  r ame 

The  first  frame,  called  "Topframe",  is  shown  in 

Figure  10.  Its  menu  is  too  large  to  appear  an  the  screen 
and  so  the  INGRES  system  places  a  right  angle  bracket,  ">", 
at  the  right  end  of  the  menu,  indicating  that  the  menu 

continues  off  the  screen  to  the  right.  Pressing  the  "MENU" 

key  results  in  the  same  frame,  but  with  the  appearance  of 
the  commands  which  could  not  be  seen  before  (Figure  11). 
Note  also,  that  there  now  appears  a  left  angle  bracket,  ”<’’, 
at  the  left  end  of  the  menu  to  indicate  that  the  menu  now 
continues  off  the  screen  to  the  left. 

From  Topframe  the  user  may  obtain  help  on  the 

various  menu  selections  via  ’’MenuHelp",  obtain  help  on  how 
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to  move  the  cursor  around  the  screen  via  "Cur so rHe 1 p" , 
select  a  function  from  the  main  menu  appearing  on  the  screen 
above,  generate  a  "Report"  of  bibliography  type  references  „ 
which  may  be  output  to  either  a  terminal  screen  or  a  line 
printer,  or  "Quit"  the  program  without  generating  a  report. 

If  "Quit"  is  selected,  any  data  rows  that  were  selected  for 
inclusion  in  an  output  report  during  the  course  of  program 
execution  are  returned  to  their  original  state,  i.e. 
"unmarked". 

2.  Topics 

Selecting  "T"  for  Topics  (subject  list)  results  in 
the  display  shown  in  Figure  12.  There  are  more  "Catcodes" 
and  "Category  Names"  than  can  appear  in  the  table  on  the 
screen.  INGRES  provides  for  the  scrolling  of  data  in 
tables.  ABF  automatically  includes  the  INGRES  scrolling 
facilities  in  any  application  program  produced  with  INGRES 
ABF.  <Ctrl>  F  is  used  to  scroll  down  the  table  a  screen  at 
a  time.  <Ctr 1 >  G  is  the  complement  of  <Ctrl>  F.  <Ctrl>  J 
scrolls  down  a  line  at  a  time  and  <Ctrl>  N  scrolls  down  an 
entry  at  a  time.  <Ctrl>  K  is  the  complement  of  <Ctrl>  J. 

All  of  the  INGRES  scrolling  functions  can  be  found  in  the 
help  facility  "CursorHelp"  which  appears  in  every  screen  and 
is  described  briefly  in  a  later  paragraph  in  this  chapter. 
Selecting  "End"  at  this  point  (and  in  every  other  screen  in 
this  application  program)  would  return  execution  to  the 
previous  screen.  "MenuHelp"  is  intended  to  be  unique  to 
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each  screen;  containing  an  explanation  of  the  menu  items  and 
options  available  from  the  particular  screen  and  its 
associated  menu.  "Titles"  provides  a  list  of  titles  in  the 
database  whose  table  entries  contain  a  matching  entry  for 
the  "Catcode"  from  whatever  row  the  cursor  is  on  at  the  time 
"Titles"  is  selected. 

3-  Titles 

Placing  the  cursor  on  the  first  row  of  the  table  in 
Figure  12  (Catcode  =  H5 )  and  selecting  "Titles",  causes  the 
screen  of  Figure  13  to  appear.  This  screen’s  table  field 
also  contains  more  entries  than  will  fit  in  the  table  on  the 
screen  and  may  be  scrolled  in  the  same  manner  as  the  last 
screen.  All  menu  selections  at  the  bottom  of  the  screen  are 
the  same  as  those  in  the  previous  screen  and  perform  the 
same  functions,  except  one.  The  "Titles"  menu  item  has  been 
replaced  by  one  called  "View".  The  purpose  of  "View"  is  to 
permit  the  user  to  select  a  title  in  the  table  field  of 
Figure  13  by  scrolling  to  it  as  before  and  then  examine  the 
pertinent  details  that  the  database  contains  regarding  that 
particular  entry.  Scrolling  to  the  first  item  in  the  table 
field  of  Figure  13,  pressing  the  Menu  key,  typing  "V"  or 
"v",  and  pressing  <Return>  yields  the  display  of  Figure  14. 

4 .  V i ewf orm 

The  display  of  Figure  14  is  called  "Viewform".  This 
is  essentially  the  bottom  level  of  the  application.  At  this 
point  the  user  may  simply  view  the  most  important  elements 
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of  the  database  entry  for  this  title  and  then  back  out  via 


the  "End"  menu  function,  or  "Save"  the  entry  in  a  customized 
bibliography  file.  Selecting  "Save"  marks  the  entry  for 
inclusion  in  the  output  report  "b i b  1  i o gr aphy . r epo r t " . 
"b i b 1 i ogr aphy . r epo r t "  is  assembled  as  the  user  departs  the 
program  from  the  entry  frame  (Figure  10)  by  selecting  the 
menu  item  "Report"  (vice  "Quit")  in  that  frame.  The  output 
report  is  written  to  the  directory  from  which  the  program  is 
run,  which  in  most  cases  should  be  the  user's  own  directory. 
The  user  may  also  unmark  any  entry  that  has  been  previously 
marked  via  the  "Save"  function  by  selecting  "Unsave".  There 
is  no  limit  to  the  number  of  times  an  entry  may  be  marked 
and  unmarked  via  "Save"  and  "Unsave".  The  functions  of  the 
remaining  menu  items  remain  the  same.  The  frame  is  departed 
via  the  "End"  command.  Three  successive  selections  of  end 
returns  the  user  to  the  entry  level  frame.  The  next  item  to 
examine  is  the  menu  item  "Keyword". 

5 •  Keyword 

Figures  15  through  17,  all  illustrate  the  "Keyword" 
screen.  In  the  previous  series,  data  entry  selections  were 
made  by  "pointing"  at  the  item  of  interest  in  a  list  of 
similar  items  and  then  selecting  from  a  menu,  a  function  to 
perform  on  that  item.  In  "Keyword",  the  user  may  input  a 
key  word  or  phrase  that  should  appear  in  the  title  of  any 
articles  of  interest,  such  as  "QUEL"  or  "INGRES"  or 
"RELATIONAL  DATABASE".  All  titles  in  which  the  key  word  or 
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phrase  appears  will  be  listed  in  the  table  field  on  the 
screen.  Although  it  is  not  reflected  in  the  illustration, 
the  "Word/Phrase*."  field  is  highlighted  in  reverse  video  to 
draw  attention  to  the  fact  that  this  is  a  required  entry. 
The  system  (INGRES)  will  also  give  an  explanatory  error 
message  if  an  attempt  is  made  to  bypass  a  required  entry 
field.  The  "Keyword”  screen  initially  appears  as  in  Figure 
15.  Having  specific  knowledge  of  a  relatively  unique  word 
in  the  sample  database,  it  is  typed  in  the  "Wor d/Phrase : " 
field.  The  "Keyword”  screen  now  appears  as  in  Figure  16. 
The  <Return>  key  has  not  yet  been  pressed  at  this  point. 
Upon  pressing  <Return>  a  number  of  internal  actions  are 
carried  out,  a  search  for  titles  containing  the  input  word 
or  phrase  is  executed,  and  the  resulting  titles  are  returned 
in  the  table  field.  The  "Keyword”  screen  now  appears  as  in 
Figure  17.  The  table  field  entry  reveals  that  there  was  only 
one  database  entry  that  satisfied  the  query  and  further  that 
there  was  no  entry  in  the  "month”  column  of  the  relation 
table  for  this  particular  row.  Moving  the  cursor  to  a  title 
in  the  table,  pressing  the  Menu  key,  typing  "V”  or  ”v”,  and 
pressing  <Return>  will  again  bring  up  the  "Viewform”  screen 
of  Figure  14.  The  functions  of  the  remaining  menu  items 
remain  the  same.  Selecting  "End”  returns  execution  to  the 
main  menu. 
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6. 


Author  s 


The  search  for  an  article  by  a  particular  author 
begins  with  the  "Authors”  frame  shown  in  Figure  18.  The 
prospective  user  is  advised  by  the  text  on  the  screen  that 
initials  are  not  required,  but  are  desirable.  The  reason 
for  this  is  obvious,  in  that  initials  will  increase  the 
uniqueness  of  the  query  and  return  a  result  closer  to  that 
which  was  both  expected  and  desired.  The  format  is 
critical,  however,  also  as  noted  in  the  text  on  the  screen. 
The  various  menu  selections  are  relatively  self  explanatory. 
Two  menu  selections  will  be  "demonstrated”,  "Author’s  name 
Only"  and  "Author’s  name  and  month  and  year  (All)  ..." 

7 .  Author’s  name  Only 

The  "Author’s  name  Only”  screen  is  shown  in  Figure 
19.  The  field  labeled  "Author:”  is  a  mandatory  entry  field 
just  as  was  the  "Wor d/Phrase : "  field  of  Figure  15.  The 
"Author”  field  has  all  the  same  attributes  of  the 
"Wor d/Phrase : ”  field,  including  reverse  video.  This  screen 
also  executes  its  function  as  soon  as  the  entry  is  completed 
and  the  <Return>  key  is  pressed.  A  list  of  titles  by  the 
author  of  interest  (who  is  not  necessarily  the  only  author 
of  the  article)  is  returned  in  the  table  field  provided. 
Using  the  cursor  control  functions  described  earlier  and 
discussed  further  below,  any  title  in  the  table  field  may  be 
scrolled  to  and  viewed  (and  subsequently  saved  for  a  report, 
if  desired).  Selecting  "End"  returns  execution  to  the 
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"Authors"  frame.  Using  the  <Tab>  key  to  move  back  to  the 
"Author:"  field  and  typing  in  another  name  followed  by 
<Return>  will  execute  another  query.  The  functions  of  the 
remaining  menu  items  remain  the  same. 

8 .  Author  and  Month  and  Year 

Figure  20  il lustrates  the  "Author  and  Month  and 
Year"  frame.  The  purpose  of  discussing  this  frame  is  that 
it  contains  multiple  required  entry  fields.  They  are 
sequenced  such  that  when  the  "Author:"  field  entry  has  been 


completed  with  the 

customary 

<Return> , 

the 

cursor 

automat i ca l l y 

proceeds 

to  the  "Month 

:"  field 

and  then 

to  the 

"Year :  "  field. 

Neither 

of  these 

fields  requires  a  <Return>. 

These  fields 

"execute" 

as  soon 

as 

they  are 

full. 

To  fill 

the  "Month:" 

field 

requ ires 

a 

s  tandar d 

three 

letter 

abbreviation  for  a  month  such  as  "JUN"  for  June,  "DEC"  for 
December,  and  so  on.  An  arbitrary  limit  has  also  been  set 
on  the  "Year:"  field  entries.  The  only  values  allowed  are 
those  four  digit  integers  between  1800  and  2200.  Any  values 
outside  this  range  will  be  rejected  with  an  appropriate 
error  message.  As  soon  as  the  "Month"  field  has  received  an 
acceptable  three  letter  abbreviation  for  a  month  the  cursor 
advances  to  the  "Year:"  field.  As  soon  as  the  fourth 
acceptable  digit  is  input,  the  retrieval  begins.  The 
functions  of  the  remaining  menu  items  remain  the  same.  The 
next  selection  to  be  discussed  is  the  "Publications"  menu 
item  which  closely  parallels  the  "Authors"  selections. 
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9. 


Pub  1  i cations 


The  "Pub  1 i cat i ons"  frame  is  illustrated  in  Figure 
21.  The  selection  of  items  from  this  menu  is  identical  in 
all  respects  to  that  of  the  "Authors"  menu  described  above. 
Only  the  execution  of  the  first  selection,  "Publication’s 
name  only",  will  be  discussed. 

1 0 .  Publication’s  name  only 

Figure  22  illustrates  the  "Pub  1 i cat i on" s  name  only" 
screen.  The  "Publication:"  field  is  a  mandatory  entry  field 
and  in  keeping  with  the  adopted  convention  it  is  in  reverse 
video  on  the  terminal  screen.  There  is  one  significant 
difference  between  the  "Publications"  series  of  queries  and 
those  of  "Authors"  and  "Keywords"  described  above.  The 
difference  is  that  this  series  only  executes  exact  match 
queries  (EMQ’s)  on  the  "Publication:"  field.  This  requires 
the  exact  name  of  the  publication  with  only  one  space 
between  each  word  (because  that  was  the  convention  adhered 


to  when  the  data 

entries  were 

put 

in  the  database). 

The 

figure  illustrates 

an  example 

using 

the 

pub  1 i ca t i on 

name 

INFORMATION  S<  MANAGEMENT.  In 

this 

case 

two  titles 

were 

returned  from  the  sample  database. 

1 1  .  Report 

The  menu  item  "Report"  in  Figure  11  is  perhaps  the 
most  important  of  all  of  the  selections  in  the  application’s 
main  menu.  "Report"  is  one  of  the  two  ways  in  which  to  exit 
the  program  "references".  When  the  program  is  exited  via 
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the  "Report”  command  all  of  the  "Saved”  entries  are 
assembled  into  a  bibliography  report  format  and  placed  in  a 
file  called  ”b i b 1 i o g r aphy . r epor t ” ,  in  the  user's  directory. 
The  name  is  coded  into  the  program  and  is  therefore 
invariant.  A  subsequent  running  of  the  program  will  result 
in  the  new  report  overwriting  the  old  report,  if  the  old 
report  is  not  first  renamed.  The  file  name 
”bib 1 iography.  report”  is  not  sacrosanct  and  may  be  changed 
to  any  legal  file  name  with  no  adverse  effects  to  the 
content  or  format  of  the  file.  After  the  report  is 
assembled  and  written  to  the  file  "b  i b  1  i o g raphy . repo r t ”  a 
final  screen  appears  to  remind  the  user  what  the  name  of  the 
file  is  and  where  to  find  it.  At  this  point  press  <Return> 
to  exit  the  program. 

12 .  Quit 

Quit  is  the  method  for  exiting  the  program  without 
generating  a  report  or  the  file  ”b i b 1 i o g raphy . r epor t ” .  When 
"Quit”  is  executed  all  previously  "Saved"  files  are  first 
restored  to  "Unsaved”  condition  and  the  program  then 
terminates  without  further  ado. 

13.  CursorHe 1 p 

Figure  23  is  actually  the  entire  file 
"keyhelp.txt".  It  cannot  all  be  viewed  at  once  as 
illustrated  in  this  figure,  but  may  be  scrolled  through 
utilizing  the  commands  provided  by  INGRES/ABF  at  the  bottom 
of  the  screen.  The  type  of  help  provided  by  "MenuHelp"  is 
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slightly  different  from  that  of  "CursorHelp”  but  the 
functioning  is  identical.  "MenuHelp"  is  not  yet  implemented 
for  all  screens . 

1 4 .  Database  Maintenance 

The  bibliographical  search  and  report  system 
described  above  does  not  include  an  integral  facility  for 
updating  the  database.  This  was  done  by  design  for  the 
purpose  of  maintaining  database  integrity.  The  database 
administrator  (DBA)  will  be  responsible  for  ensuring  that 
appropriate  entries  are  added  to  or  deleted  from  the 
database.  This  can  easily  be  accomplished  through  INGRES 
Query -By-Forms  (QBF)  by  first  invoking  QBF  and  subsequently 
entering  the  QBF  name  "form3"  when  prompted  for  a  Table  or 
QBF  name.  QBF  provides  all  the  functions  necessary  to  add, 
delete,  or  update  items  in  the  database.  An  INGRES  V 1  FRED 
forms  description  of  the  elements  that  comprise  "form3,f  can 
be  found  at  the  end  Appendix  B. 

C.  THE  PROGRAMMING  ENVIRONMENT 

A  frame  is  the  basic  screen  oriented  user  interface  in 
INGRES.  The  applications  programmer,  working  from  within 
the  ABF  environment,  builds  the  two  basic  components  of  a 
frame,  the  form  and  the  OSL  specification  for  the  frame. 
These  two  components  are  then  combined,  also  from  within 
ABF,  to  form  frames.  Figures  24  and  25  illustrate  the 
Application  Definition  frame.  The  items  in  the  menu  at  the 
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bottom  of  the  frame  indicate  the  range  of  operations 
available  from  within  ABF.  If  the  user  selects  "Rt ingres”, 
the  screen  of  Figure  1  appears,  providing  access  to  all  of 
the  INGRES  subsystems.  "Options"  permits  the  user  to  select 
the  text  editor  to  be  used  to  edit  the  ".osl"  files.  The 
".osl"  files  provide  the  menu  selections  for  the  frame  to 
which  it  belongs,  and  contains  the  OSL  and  QUEL  statements 
required  to  perform  the  actions  indicated  by  the  menu  item 
names.  "Define"  and  "Create"  are  used  to  initiate  new 
applications  or  frames  or  to  edit  or  redefine  already 
existing  frames.  "Destroy"  is  used  to  destroy  either  a 
frame  at  a  time  or  an  entire  application.  "Go"  is  used  to 
run  an  application  that  is  still  in  the  development  stage, 
particularly  one  that  hasn’t  yet  been  compiled  .to  a  ".exe" 
file.  "Image"  is  the  command  to  compile  an  application  to 
an  executable  (.exe)  file.  Figure  26,  the  "User-Specified 
Frame  Definition"  frame,  provides  the  remainder  of  the 
facilities  required  to  develop  an  application.  Of 
particular  importance  in  this  frame  are  "Compile",  "Edit" 
and  "Vifred".  "Vifred"  permits  access  to  the  forms  editor 
to  edit  the  form  for  the  current  frame  without  having  to 
leave  ABF.  Edit  allows  for  direct  entry  into  the  chosen 
editor  with  the  appropriate  ".osl"  file  as  the  object  to  be 
edited.  "Compile"  permits  compiling  of  ".osl"  files  for  the 
purpose  of  checking  for  syntax  and  other  related  errors. 
Although  beyond  the  scope  of  this  thesis,  a  comment 
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regarding  V1FRED  is  in  order.  Much  of  what  can  be  done  with 
an  application  is  the  result  of  the  wide  variety  of 
attributes  that  may  be  edited  into  a  form  through  the  use  of 
VIFREDTs  attribute  editor,  a  frame  from  which  is  illustrated 
in  Figure  27.  Finally,  although  INGRES  provides  many  ways 
to  initiate  a  relation  table  in  the  database,  there  is 
probably  none  easier  than  by  the  selection  of  the  "Table" 
option  in  the  rtingres  menu.  The  table  information  frames 
for  the  two  tables  which  form  the  underlying  relations  for 
the  sample  database  of  this  application,  "descr i pt2"  and 
"bibindex",  are  shown  in  Figures  28  and  29,  respectively. 
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III.  SUMMATION  AND  RECOMMENDATIONS 


Overall  the  INGRES  Application-By-Forms  (ABF)  subsystem 
was  found  to  be  straightforward,  easily  understood,  and 
easily  used  once  the  initial  learning  curve  was  passed.  The 
initial  task  of  gaining  familiarity  with  the  system  is  not 
an  insignificant  one.  The  first  bit  of  wisdom  gained  by  the 
experience  of  this  development  project  is  that  it  is 
necessary  to  learn  nearly  the  entire  INGRES  system  in  order 
to  make  effective  use  of  all  of  the  facilities  INGRES 
offers.  In  fact,  it  is  necessary  to  learn  the  entire  system 
in  order  to  make  effective  use  of  just  a  portion  of  the 
system,  and  to  know  which  is  the  appropriate  portion  to 
utilize  for  a  given  task.  While  it  is  true  that  an 
application  may  be  built  with  the  INGRES/ABF  reference 
manual  in  hand,  by  modifying  existing  code  in  the  examples 
in  the  manuals,  such  an  approach  results  in  applications  of 
severely  limited  scope. 

A.  LANGUAGES 

In  addition  to  an  overall  systems  knowledge,  the 
prospective  application  programmer  must  allocate  some  time 
to  gain  familiarity  with  the  languages  used  by  the  system. 
These  are  the  Report  Specification  Language  (RSL),  the 
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Operations  Specification  Language  (OSL),  and  Query  Language 
(QUEL) . 

RSL  is  used  primarily  in  conjunction  with  the  INGRES 
Report-Writer  and  Report-By-Forms  (RBF)  subsystems.  RSL  is 
very  similar  in  syntax  and  semantics  to  OSL,  discussed 
below.  RSL  will  not  be  discussed  further  since  its  systems 
lie  outside  the  scope  of  this  thesis. 

OSL  is  the  language  used  in  ABF  to  specify  the  menu 
items  at  the  bottom  of  the  screen,  which  is  called  a  frame 
in  INGRES.  The  majority  of  the  later  chapters  of  the 
App 1 ications-By-Forms  User’ s  Guide  [Ref.  43  contain  a 
combination  tutorial  and  reference  manual  for  OSL.  OSL 
statements  are  collected  into  files  with  a  ".osl"  suffix  to 
enable  the  INGRES  system  to  identify  its  source  code  files. 
OSL  commands  can  be,  and  usually  are,  combined  with  QUEL 
statements  in  order  to  broaden  the  scope  and  power  of  menu 
functions.  The  structure  of  OSL  code  segments  is 
reminiscent  of  "C"  code  segments,  beginning  and  ending  with 
the  curly  brace.  However,  OSL  is  semantically  at  the 
opposite  end  of  the  scale  from  "C",  resembling  macros  in  the 
effect  of  its  commands.  OSL  statements  take  the  form  of 
words  and  phrases  such  as  "return",  "resume  field”, 
"cal  If rame",  "cal  lproc",  "exit"  and  so  forth.  OSL's  primary 
function  is  to  direct  the  flow  of  control  throughout  an 
INGRES  application  program.  As  implied  previously,  OSL  is 
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generally  supplemented  by  QUEL  statements  in  order  to  have  a 

menu  selection  specified  in  OSL  perform  a  data  retrieval, 

update,  or  some  similar  database  function  for  which  QUEL  is 

* 

des i gned . 

INGRES  QUEL  is  similar  in  syntax  and  semantics  to  the 
many  other  existing  versions  such  as  that  offered  by  DBASE 
I  I  and  III.  The  reader  is  referred  to  any  general  ly 
available  text  on  the  subject.  QUEL,  OSL,  and  RSL  are  all 
small  but  powerful  languages  designed  for  a  specific,  narrow 
purpose.  Since  they  are  smal 1  and  the  syntax  is 

straightforward,  it  is  easy  to  gain  an  appreciable  measure 
of  familiarity  with  them  in  a  relatively  short  period  of 
time. 

In  summary,  with  respect  to  languages,  the  prospective 
INGRES  applications  programmer  must  either  possess,  or  gain 
a  working  knowledge  of  QUEL  and  OSL  in  order  to  write  the 
”.osI"  modules  required  to  bring  function  to  menus.  Once 
this  aspect  is  mastered  it  is  a  simple  matter  to*  change  the 
menu  items  in  any  given  frame/screen  by  simply  changing  a 
few  OSL  statements  and  recompiling  the  ”.osl”  file. 

B.  HELP  SCREENS 

ABF,  actually  OSL,  provides  a  uniquely  easy  to  use 
facility  for  including  help  screens.  The  OSL  command  syntax 
is  " helpfile  '  f subject '  'filename'",  where  "subject"  is  a 
character  string  which  will  be  inserted  into  the  INGRES 
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system  error  message  "Sorry  - -  cannot  open  help  file  on 
'subject' " .  This  message  is  displayed  in  the  event  that  the 
system  cannot  locate  the  actual  text  file,  "filename", 
containing  the  information  for  the  help  screen.  "filename" 
should  contain  the  entire  path  designation  required  for  the 
system  to  find  the  file.  The  ability  to  easily  provide  the 
end  user  with  on-line  help/assistance  facilities  encourages 
the  application  programmer  to  do  so.  This  of  course  tends 
to  foster  more  "user  helpful",  if  not  "user  friendly" 
so  f  twar e . 

C.  CURSOR  CONTROL 

A  very  positive  aspect  of  developing  programs  with  ABF 
is  the  fact  that  the  same  cursor  control  features  available 
to  the  applications  programmer  in  the  programming 
environment,  are  inherited  by  the  application  written  in 
this  environment,  and  are  subsequently  available  to  the  end 
users  of  the  application.  All  that  remains  is  to  make  the 
end  user  aware  of  the  capability  and  perhaps  provide  some 
on-line  help,  as  was  done  in  the  application  "references" 
with  the  menu  item  "Cur sorHe 1 p" ,  which  is  available  on  every 
screen. 

D .  EFF 1 C I ENCY  CONS  1  DERAT  I ONS 

The  response  time  of  a  database  query  is  at  least  in 
part  related  to  the  storage  structure  of  the  data.  Although 
not  strictly  a  feature  of  ABF  specifically,  INGRES  provides 
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some  latitude  in  the  selection  of  an  appropriate  storage 
structure  for  a  given  application.  The  default  structure  is 
the  heap,  but  several  others  are  available.  RT 1  has 
provided  some  guidance  on  this  issue  with  respect  to  the 
options  available  in  the  INGRES  system  [Ref.  5,  chap  17]. 


E.  OPERATIONS  IN  OSL 

The  frames  used  in  an  application  program  may  have 
primarily  one  of  two  origins;  Query -By-For ms  (QBF)  frames 
and  User -Speci f ied  frames.  User-Specified  frames  provide 
the  applications  programmer  with  a  considerable  amount  of 
latitude  in  both  how  a  frame  appears  and  how  the  frame 
operates.  The  operations  in  a  User -Speci f i ed  frame  fall 
into  three  categories*,  menu  items,  field  activations  and 
initializations.  Examples  of  all  three  of  these  methods  of 
operation  can  be  found  throughout  the  program  "references”. 
RT 1  [Ref.  4,pg  9-1]  provides  the  following  explanations  of 
these  three  categories  .of  operations* 

Menu  items  are  the  most  common  type  of  operation 
in  a  forms  application.  They  provide  the  operations 
that  appear  in  the  menu  at  the  bottom  of  the  screen.  By 
selecting  a  menu  item,  the  user  can  execute  the 
indicated  operation.  Such  an  operation  could  include  a 
variety  of  specific  actions,  and  could  be  a  combination 
of  database  and  forms  manipulations. 

Field  activations  are  less  common,  but  nonetheless 
very  useful.  Field  activations  occur  when  an  end-user 
enters  a  value  in  a  field  and  then  tries  to  move  to  the 
next  field.  If  the  application  designer  has  defined  a 
field  activation  on  that  field,  then  the  operation 
specified  is  carried  out. 
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An  initialization  occurs  when  a  field  is  first 
displayed.  Although  initializations  can  cause  any  action 
to  occur,  they  are  normally  used  to  set  up  the  frame. 

An  example  of  a  field  activation  occurs  in  "references” 
in  the  frames  under  "Authors"  and  "Publications"  which 
contain  fields  for  month  and  year  entries.  An  example  of  an 
initialization  occurs  in  the  "View"  frame.  The  code  for 
this  field  activation  is  found  in  the  OSL  file 
" v i ewf r ame . os  1 " .  Menu  items,  as  RT I  remarks,  are  common  and 
found  throughout  the  application. 

F.  FIELD  ATTRIBUTES 

The  ability  to  edit  a  field’s  attributes  was  mentioned 
previously  but  deserves  a  section  in  the  summary  as  well. 
This  facility  is  actually  a  part  of  another  INGRES 
subsystem,  the  Visual  Forms  Editor  (VIFRED).  VIFRED  is  the 
medium  through  which  the  forms,  which  make  up  the  majority 
of  that  which  is  visible  in  a  frame,  are  created  and 
revised.  It  is  highly  recommended  that  the  applications 
programmer  become  intimately  familiar  with  the  VIFRED 
subsystem.  Mastering  VIFRED  will  open  an  entirely  new 
dimension  in  screen  and  field  control  through  the  proper 
utilization  of  field  attribute  editing.  An  examination  of 
the  menu  of  attributes  that  may  be  controlled,  Figure  27, 
should  serve  to  illustrate  the  point.  There  is  at  least  one 
item  in  this  list  which  is  of  limited  utility,  however.  The 
ability  to  provide  a  default  value  for  a  field  is  severely 
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limited  in  its  usefulness  when  it  is  for  display  purposes 
only.  In  the  "Keyword"  frame  of  the  program  "references",  a 
default  value  of  the  wild  card  character,  was  provided 
for  the  "Word/Phrase:"  field,  which  is  also  a  mandatory 
field.  When  the  frame  appears  on  the  screen,  the  asterisk 
appears  in  the  "Word /Phrase : "  field,  but  pressing  <Return> 
only  results  in  a  system  message  to  the  effect  that  this  is 
a  mandatory  field  and  an  entry  is  required.  This  indicates 
that  INGRES  does  not  recognize  the  default  value  in  a  field 
as  a  legitimate  query  object.  This  fact  is  not  well 
documented,  if  at  all. 

G.  MISCELLANEOUS 
1  •  Word  Wrap 

The  user  will  note,  probably  with  some  degree  of 
subliminal  irritation,  that  text  in  text  fields  does  not 
word  wrap.  This  shortcoming  is  not  uniform  throughout  the 
INGRES  system.  Although  the  ability  to  have  text  word  wrap 
does  not  occur  in  the  QBF  or  ABF  associated  subsystems,  it 
is  available  in  the  RBF  associated  subsystems.  Among  other 
things,  what  this  means  to  a  user  of  an  application  such  as 
"references"  is  that  any  text  the  user  views  in  frames  on 
the  screen  will  not  word  wrap,  but  the  output  report 
"b i b l i o g r aphy  .  r epor t "  will  have  its  text  neatly  word 
wrapped.  INGRES  is  in  a  constant  state  of  revision  and 
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perhaps  a  future  version  will  uniformly  offer  the  option  to 
have  text  fields  word  wrap. 

2 .  Regularity  Violation 

It  is  probably  a  bit  strong  to  accuse  RT 1  of  a 
violation  of  the  regularity  principle  [Ref.  6,pg  527],  but 
they  have  come  close  in  their  "Vifred’’  menu  selection  in  the 
ABF  "User -Spec i f i ed  Frame  Definition"  frame,  Figure  26.  In 
normal  operation  of  the  VIFRED  subsystem,  it  is  possible  to 
"copy"  an  existing  form,  for  whatever  purpose,  perhaps 
modification  into  a  slightly  different  version  of  the  same 
form.  The  method  (undocumented)  for  copying  a  form  is 
simply  to  enter  VIFRED  and  arrive  by  whatever  fashion  at  the 
"Forms  Catalog"  frame,  Figure  30.  Move  the  cursor  to  the 
form  to  be  copied  and  select  the  "Edit"  menu  item.  When  the 
form  appears  on  the  screen,  edit  it  as  desired  and  then 
select  "Save".  The  "Save"  screen,  Figure  31,  will  then 
appear  with  the  old  form’s  name  in  the  "form  name:"  field. 
In  this  instance,  the  name  may  be  changed  at  this  point  and 
"Save"  selected  from  the  menu.  The  old  form  from  which  the 
new  form  was  made  is  still  in  the  forms  catalog  as  is  the 
new  form.  The  sequence  of  events  just  described  to  copy  a 
form  cannot  be  accomplished  if  VIFRED  was  entered  via  the 
ABF  "User-Specified  Frame  Definition"  frame’s  "Vifred"  menu 
item.  When  the  user /programmer  arrives  at  the  "Save"  frame 
and  attempts  to  change  the  name  of  the  form,  an  error 
message  appears  indicating  that  this  is  not  a  permissible 
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action  and  that  the  form  name  is  for  display  only. 


The 


reader  is  left  to  form  his  or  her  own  opinion. 

3 .  Retrieve  Lockout 

The  problem  described  here  is  not  fully  understood, 
but  is  described  for  the  purpose  of  forewarning  a  potential 
applications  programmer  about  a  possible  "glitch"  in  the 
system.  The  Us e r -Re  1  a t i o n  table  field  description  for  the 
relation  "descr i pt2"  is  shown  in  Figure  28.  During  the 
course  of  developing  the  program  "references",  several 
attempts  were  made  to  execute  an  imbedded  QUEL  retrieve  of 
various  items  of  the  relation  descript2  using  other  items 
from  the  relation,  i.e.,  "retrieve  descript2. title  where 
descr i pt2. author  =  fADlBAT,"  for  example.  All  queries  were 
handled  satisfactorily  except  for  one  which  always  failed  to 
compile  in  a  ”. osl "  file.  The  query  which  always  gave  a 
syntax  error  was  any  query  containing  descr i pt2 . key„  as  the 
object  of  the  query,  i.e.,  "retrieve  descr  i  pt2 .  keyi  where 
descr i pt2 . author  =  ’ ADIBA’ . "  As  can  be  seen  from  Figure  28, 
there  is  nothing  different  about  this  column  in  the  relation 
descript2,  except  that  it  is  the  first  one.  The  INGRES 
Reference  Manual  [Ref.  7]  indicated  that  the  word  "key"  was 
not  a  reserved  word.  There  exists  the  possibility  that 
INGRES  considers  the  first  column  in  any  relation  to  be  a 
"key"  or  "index"  item  as  discussed  in  [Ref.  7,pg  2-24]  and 
additionally  that  retrievals  are  not  permitted  on  designated 
or  default  indexes.  That  is  only  speculation,  however,  with 
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no  other  evidence  or  documentation  to  substantiate  the 


hypothesis. 

4  .  Default _ Editj?jr_ 

ABF  either  contains  or  calls  a  default  editor  when 
the  "Edit"  function  is  called  on  a  frame.  ABF  does  provide 
for  the  programmer  the  opportunity  to  change  the  default 
editor  for  the  duration  of  the  current  session  through  the 
"Option"  menu  item.  The  problem  arises  that  the  default 
editor  cannot  be  permanently  changed  by  the  user  and  the 
editor  that  RT 1  has  chosen  is  not  well  known  at  this 
installation.  It  is  neither  "vi"  nor  "ex",  but  does  appear 
to  be  a  line  editor  similar  to  "ex".  Since  ABF  is  a 

"programming  environment",  it  would  not  seem  unreasonable 
for  the  applications  programmer  to  be  permitted  to  designate 
his/her  own  default  text  editor  on  a  semi -permanent  basis. 
This  suggestion  is  offered  in  the  spirit  of  providing  the 
user  of  the  programming  environment  with  a  more  congenial 
atmosphere  in  which  to  work. 

H.  CLOSING  COMMENTS 

Overall  INGRES  ABF  was  found  to  provide  an  extremely 
flexible  application  programming  environment.  The  system  is 
not  difficult  to  learn  from  the  standpoint  of  complexity  or 
understanding,  but  the  sheer  bulk  of  the  systems  manuals  is 
at  first  intimidating.  It  is  noted  that  version  4.0  has 
arrived  at  this  installation  and  that  the  manuals  have  been 
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reduced  by  half. 


It  should  be  noted  one  last  time  that  it 


is  considered  necessary  for  an  applications  programmer  to 
learn  the  majority  of  the  subsystems,  unlike  a  casual  user 
who  only  needs  to  learn  QBF  in  order  to  make  forms  oriented 
queries.  Once  the  initial  learning  curve  has  been 
surmounted,  the  system  provides  a  very  complete  and 
comfortable  application  programming  environment. 
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APPENDIX  A.  F I GURES 


INGRES/MENU  Database:  biblio 

To  run  a  highlighted  command,  place  the  cursor  over  it  and 
select  the  "Go"  nenu  item. 


CoMands 

Description 

QUERY 

RUN  simple  or  saved  QUERY  to  retrieve,  modify  or  append  data 

REPORT 

RUN  default  or  saved  REPORT 

QBF 

Use  QUERY-BY-FORMS  to  develop  and  test  query  definitions 

RBF 

Use  REPORT-BY-FORMS  to  design  or  modify  reports 

ABF 

Use  APPL 1CAT 1 ONS-BY-FORMS  to  design  and  test  applications 

TABLES 

CREATE,  MANIPULATE  or  LOOKUP  tables  in  the  database 

VI  FRED 

EDIT  forms  by  using  the  V 1 SUAL-FORMS-ED 1  TOR 

QUEL 

ENTER  interactive  QUEL  statements 

SREPORT 

SAVE  REPORT-URITER  coamands  in  the  reports  catalog 

Go  History  CotnandMode  DBsvitch  Shell  Help  Quit 


Figure  1  INGRES/MENU's  executive  level  menu 
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INGRES/MENU 


Database:  biblio 


QUERY-BY-FORMS  Intonation 


Enter  a  table  naoe,  a  qbfnaae,  or  a  joindef  naae: 


Change  default  options  if  desired: 

Type  ("table",  "qbfnaae",  "joindef"  or  "any"):  any 

If  a  table  is  specified,  indicate  if  a  table  field  is  to  be  used 
( "y" f  "n"):  n 

Select  the  "Go"  aenu  itea  to  start  QUERY-BY-FORMS. 

Go  Help  End 

Figure  2  Initial  QBF  screen  from  within  INGRES/MENU 
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QBF  -  Start-Up  Fraae 

Query-By-Forns  (QBF)  is  an  interactive  interface  for  adding,  deleting, 
changing  and  viewing  data  in  your  database. 

You  aay  get  a  catalog  of  QBFNaaes,  JoinDefs,  or  Tables  in  your  database 
to  serve  as  a  basis  for  editing  and  viewing.  In  sunaary,  they  are* 

QBFNane  -  a  naae  that  conbines  a  joindef  or  table  naae  with  a 
fora  naie.  QBFNaaes  are  created  in  VIFRED. 

JoinDef  -  a  stored  specification  of  joins  between  tables,  and 
rules  governing  how  to  update  data  in  QBF. 

Table  -  a  table  or  view  in  your  database. 

Froa  each  of  the  catalogs,  you  can  browse  names,  and  choose  one 
to  serve  as  a  basis  for  editing  or  viewing. 

Additional  utility  coanands  on  this  aenu  are** 

Help  -  displays  help  on  QBF  and  your  terainal  key  functions. 
Quit  -  leaves  QBF. 


QBFNaaes  JoinDefs  Tables  Help  Quit  : 

Figure  3  INGRES  QBF  Start-up  frame 
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INGRES/MENU 


Database:  biblio 


Go 

F i gure 


VISUAL-FORMS-EDITQR  Information 


Enter  a  fora  name,  table  naae  or  joindef  name: 


Change  default  options  if  desired: 

Type  ("form",  "table",  "joindef"):  form 


Select  the  "Go"  aenu  item  to  start  VISUAL-FORMS-EDITOR, 

Help  End 

4  Initial  V 1  FRED  screen  from  within  INGRES/MENU 


43 


V1FRED  -  Forns  Catalog 


Naae 

Owner 

addrfon 

destael 

projfors 

destael 

staffora 

destael 

taskforn 

destael 

Position  cursor  over  the  name  of  the 
fori  you  wish  to  select,  then  use 
the  semi  to  perfori  the  appropriate 
operation  on  that  fori. 


Create  Destroy  Edit  Renaoe  Utilities  Find  Top  Bottom  > 
Figure  5  INGRES  V  I  FRED  Forms  Catalog 


f  rame 
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INGRES/ HENU 


Database:  biblio 


REPORT-BY-FORMS  Inforaation 


Enter  a  table  nane  or  a  report  naae: 


Change  default  options  if  desired: 

Type  ("report",  "table",  "any"):  any 
Suppress  RBF  status  aessages  ("y",  "n")?  n 

For  report  on  table  above,  enter  report  style 
("block",  "coluin",  "urap"  or  "default"):  default 


Select  the  "Go"  aenu  itea  to  start  REPORT-BY-FORMS. 


Go  Help  End 


Figure  6  RBF  initial  screen  from  INGRES  MENU 
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RBF  -  Reports  Catalog 


Position  cursor  over  the  na*e  of  a  report,  then  use  the  appropriate 
nenu  item  to  perforn  an  operation  on  that  report. 


Naae 

Owner 

RBF? 

Last  changed 

sub j l ist 

_ j 

destael 

Yes 

4-nov-86  22:50 

Create  Destroy  Edit  Renane  Utilities  Find  Top  Bottoa  > 

Figure  7  RBF  Reports  Catalog  frame 
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INGRES/ MENU 


Database:  biblio 


APPL1CATI ONS-BT-FORMS  Inforaation 


Enter  an  application  naie: 


Select  the  "Go*  aenu  itei  to  start  APPLICATIONS-BY-FORHS. 


Go  Help  End 


Figure  8  Initial  ABF  screen  from  within  INGRES/MENU 
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APPLICATION  DEFINITION 


APPLICATION  CREATION  INFORMATION: 

Application  Nane  :  references  Date  Created  :  L8-nov-8€: 17:52 

Application  Creator  :  destael  Date  Modified  :  19-nov-86: 17:02 


Source  Code  Directory  :  /work/destael/reference 


Frane 

Procedure 

frane3a 

frane3ay 

fra»e3ai 

f raie3aiy 

Define  Go  Create  Destroy  Inage  Rtingres  Options  Help  > 

Figure  9  INGRES  ABF  Application  Definition  frame 
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«  We  leone  to  REFERENCES  •  •• 


Would  you  like  to  see: 

<T>  A  list  of  Topics  (  subject  list  ) 

<K>  A  list  of  titles  containig  a  Key  word  or  phrase 

(  i.e.  such  as  "DATABASE"  or  "FOURTH  GENERATION  LANGUAGE"  ) 

(A>  A  list  of  titles  based  on  some  combination  of  Author  and 
month  and/or  year 

<P>  A  list  of  titles  based  on  some  combination  of  Publication  and 
month  and/or  year 


CursorHelp  HenuHelp  Topics  Keyword  Author  Publication  >  : 

Figure  10  Topframe  (left  half  of  menu) 
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•  ••  We  I  cone  to  REFERENCES  1,1 

Would  you  like  to  see: 

<T>  A  list  of  Topics  (  subject  list  ) 

<K>  A  list  of  titles  containig  a  Key  word  or  phrase 

(  i.e.  such  as  "DATABASE"  or  "FOURTH  GENERATION  LANGUAGE"  ) 

<A>  A  list  of  titles  based  on  soae  coibination  of  Author  and 
nonth  and/or  year 

<P>  A  list  of  titles  based  on  soae  coabination  of  Publication  and 
aonth  and/or  year 


<  Publication  Report  Quit  : 


Figure  11  Topframe  (right  half  of  menu) 
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Subject  List 


Catcode 

Category  Name 

H5 

DATABASE  MAINTENANCE  -  OTHERS 

11 

DISTRIBUTED  DATABASES 

12 

DISTRIBUTED  DATABASE  MANAGEMENT  SYSTEMS 

121 

SDD-1 

122 

HETEROGENOUS  DISTRIBUTED  DBMS'S 

13 

DESIGN,  MODELING  AND  EVALUATION  OF  DISTRIBUTED  DBMS'S 

131 

FILE  AND  PROCESS  ALLOCATION 

132 

_ 

SYSTEM  DESIGN  OF  DISTRIBUTED  DBMS'S 

CursorHelp  HenuHelp  Titles  End  : 

Figure  12  Topics  (subject  list)  frame 
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Category  Code:  H5 

Category:  DATABASE  MAINTENANCE  -  OTHERS 

Titles 

FLASH  :  A  LANGUAGE- INDEPENDENT,  PORTABLE  FILE  ACCESS  SY 
STEM 

A  MODEL  FOR  AUTOMATIC  FILE  AND  PROGRAM  DESIGN  IN  BUSINE 
SS  APPLICATION  SYSTEM 

GENERALLY  APPLICABLE  DATA-FILE  SOFTWARE 

GiS  AND  FILE  MANAGEMENT 


CursorHelp  MenuHelp  View  End  : 


Figure  13  Titles  frame 
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Press  <CTRL>  F  to  view  bottoi  of  page. 

Month:  MAY  Article  Description  Year-'  I960 

Title:  FLASH  :  A  LANGUAGE- INDEPENDENT,  PORTABLE  FILE  ACCESS  SY 
STEM 


Authors:  ALLCHIN, J.E.,  KELLER, A. M. ,  U I EDERHOL, D. G. 


•Publication:  PROCEEDINGS  OF  ACM-SIGHOD  1982  INTERNATIONAL  CONFERENCE 
ON  MANAGEMENT  OF  DATA 


Abstract: 

A  brief  description  (synopsis)  of  the  article,  not  to  exceed  1500  charac 
ters  is  to  be  inserted  here... 


CursorHelp  MenuHelp  Save  UnSave  End  : 


Figure  14  Viewframe 
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*>■  Listing  of  Titles  Containing  a  Key  Word  or  Phrase  »«• 
Vord/Phrase:  * 


CursorHelp  MenuHelp  Viev  End  : 


Figure  15  Keyword  (initial)  frame 
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Listing  of  Titles  Containing  a  Key  Uord  or  Phrase 
Vord/Phrase:  GIS 


Month 


Year 


Title 


J _ 


CursorHelp  MenuHelp  View  End 


Figure  16  Keyword  (intermediate)  frame 
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»»»  Listing  of  Titles  Containing  a  Key  Word  or  Phrase  »»> 
Uord/Phrase:  »GIS» 


CursorHelp  NenuHelp  View  End 


Figure  17  Keyword  (final)  frame 
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•••  Authors 

Would  you  like  to  construct  a  list  of  titles  based  on: 

<0>  Author's  nane  Only 

<Y>  Author's  naae  and  Year  of  publication  of  his/her  article 

<M>  Author's  naie  and  Month  of  publication  of  his/her  article 

<A>  Author's  name  and  aonth  and  year  (All)  of  publication  of 
his/her  article 

Note  ••• 


When  entering  the  author's  naue  the  syntax  is:  "LASTNAME, F.M. 0 . 
Initials  are  not  required  but  are  desirable. 

There  should  be  NO  SPACES. 


CursorHelp  MenuHelp  Only  Year  Month  All  End  : 


Figure  18  Authors  frame 
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Month,  Year,  and  Title  of  Article  Based  On  Author's  Na«e  Only  «»« 
Author:  ■AD1BA* 


honth 

Year 

Title 

SEP 

1978 

ISSUES  IN  DISTRIBUTED  DATA  BASE  MANAGEMENT  SYSTEM:  A  TE 
CHI CAL  OVERVIEW 

OCT 

1980 

AN  OVERVIEW  OF  THE  POLYPHEHE  DISTRIBUTED  DATABASE  MAN AG 
EMENT  SYSTEM 

SEP 

1978 

A  DISTRIBUTED  DATA  BASE  SYSTEM  USING  LOGICAL  RELATIONAL 

MACHINES 

CursorHelp  HenuHelp  View  End 


Figure  19  Author  Only  frame 
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Author:  »DIB 


**•  Titles  Based  On  Author,  Month,  and  Year  »»» 


Month:  SEP 
Year:  1978 


Title 


ISSUES  IN  DISTRIBUTED  DATA  BASE  MANAGEMENT  SYSTEM:  A  TE 
CHICAL  OVERVIEW 

A  DISTRIBUTED  DATA  BASE  SYSTEM  USING  LOGICAL  RELATIONAL 
MACHINES 


CursorHelp  MenuHelp  View  End 


Figure  20 


Author  and  Month  and  Year  frame 


»«•  Publications  «»• 

Would  you  like  to  construct  a  list  of  titles  based  on: 

<P>  Publication's  nane  only 

<Y>  Publication's  nane  and  Year  of  publication 

<H>  Publication's  nane  and  Month  of  publication 

<A>  Publication's  nane  and  nonth  and  year  of  publication  ( <A> 1 1  > 

III 

NOTE:  Put  only  single  spaces  between  words  in  publication  naies. 


CursorHelp  MenuHelp  PubNane  Year  Month  All  End  : 

Figure  21  Publications  frame 
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Month,  Year,  and  Title  of  Article  Based  On  Publication  Nane  Only  •»« 
Publication:  INFORMATION  &  MANAGEMENT 


CursorHelp  MenuHelp  View  End  : 


Figure  22  Pub  Name  Only  frame 
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HELP  --  Coanand-Key  Happing  for  QUERY-BY-FORMS  INFORMATION 


Conaand 

Control /Function  Key 

Explanation 

Menu 

ControlESC 

Go  to  or  scroll  through  the  »enu  line 

Scroll  up 

AF 

Go  to  next  page  of  table  or  fori 

Scrol Idown 

AG 

Go  to  previous  page  of  table  or  fora 

Nextfield 

Tab 

Go  to  the  next  field 

Previousf ieid 

AP 

Go  to  the  previous  field 

Scrol lleft 

A0 

Scroll  fora  to  the  left 

Scrol Iright 

AU 

Scroll  fora  to  the  right 

Startfield 

[ 

Go  to  start  of  current  field 

Endfield 

] 

Go  to  end  of  current  field 

Leftchar 

AH 

Move  left  one  space 

Rightchar 

AL 

Move  right  one  space 

Downline 

AJ 

Move  down  one  line 

Upline 

AK 

Move  up  one  line 

Nextword 

AB 

Move  forward  one  word 

Previousword 

AR 

Move  backward  one  word 

Mode 

AE 

Switch  edit  aode  -  insert/overstrike 

Redraw 

A« 

Redraw  the  screen 

Deletechar 

AD 

Delete  character  under  cursor 

Rubout 

Delete 

Delete  character  to  left  of  cursor 

Editor 

AV 

Start  systea  editor  on  field 

Newrow 

AN 

Move  to  first  coluan  on  next  row 

Clear 

AX 

Clear  field  or  aenu  input 

Clearrest 

Return 

Clear  field  froa  cursor  to  end 

Duplicate 

AA 

Duplicate  last  value  entered 

Printscreen 

Write  current  screen  to  file 

Go 

Help 

End 

NeitPage('F)  PrevPage(AG)  Find  Top  Bottoa  Help  End 


Figure  23  CursorHelp  frame  text  file 
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APPLICATION  DEFINITION 


APPLICATION  CREATION  INFORMATION: 

Application  Name  :  references  Date  Created  :  l8-nov-86: 17:52 

Application  Creator  :  destael  Date  Modified  :  15-dec-86:02:03 


Source  Code  Directory  :  /uork/destael/reference 


Fraue 

Procedure 

kvfr 

pub frame 

pofr 

p*fr 

Define  Go  Create  Destroy  Image  Rtingres  Options  Help  >  : 


Figure  24  Application  Definition  frame  Cleft  half) 
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APPLICATION  DEFINITION 


APPLICATION  CREATION  INFORMATION: 

Application  Naae  :  references  Date  Created  :  18-nov-86: 17:52 

Application  Creator  :  destael  Date  Modified  :  15-dec-86:02:03 


Source  Code  Directory  :  /uork/destael/reference 


Frace 

Procedure 

kvfr 

pubfraae 

pofr 

paf  r 

<  Help  Quit  : 


Figure  25  Application  Definition  frame  (right  half) 
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User-Specified 

Fraie  Name  :  endfr 
Usage  :  USER 
Fori  :  endfora 


Fraae  Def ini t ion 

Creation  Date  :  14-dec-66: 15:51 

Modification  Date  :  14-dec-86: 16:39 

Return  Type  :  character 
("integer",  "float",  "character", 
or  "none") 


Define  Compile  Destroy  Edit  Print  Vi f red  Help  End  : 

Figure  26  Frame  Definition  frame 
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VIFRED  -  Attributes  for  Field 


Attribute 

Set 

Box  Field 

n 

Keep  Previous  Value 

n 

Mandatory  Field 

y 

Reverse  Video 

y 

Blinking 

n 

Underline 

n 

Brightness  Change 

n 

Query  Only 

y 

Force  Lower  Case 

n 

Force  Upper  Case 

y 

No  Auto  Tab 

n 

No  Echo 

n 

Display  Only 

n 

END  OF  ATTRIBUTES 

Default  Value  for  Field: 


Internal  Naae  for  Field  (12  characters  only): 
authors 


Validation  Check  to  Perfon  on  Field: 


Validation  Error  Message: 


Color:  0 


Next  Previous  Help  End 


Figure  27  VIFRED  Field  Attributes  Editing  frame 
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INGRES  TABLE  UTILITY 


Database:  biblio 


lnfornation  on  table  descript2 


Coluin  Name 

Data  Foraat 

key 

c7 

authors 

C110 

title 

cl65 

publication 

cll0 

vo 1  use 

il 

nunber 

il 

nonth 

c3 

year 

i2 

pages 

c9 

catcode 

c3 

synop 

te«t(15M) 

reptout 

cl 

Owner:  destael 

Nufiber  of  Colunns:  12 
Nunber  of  Rows:  63 

Table  Type: 

Storage  Structure:  heap 
Row  Width:  1914 

Journaling: 


USER  RELATION 


Disabled 


NewTable  Find  Top  Bottoi  Help  End 


Figure  28  Database  Relation  Table  "descr i pt2” 
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INGRES  TABLE  UTILITY 


Database*  bib) io 


Intonation  on  table  bibindex 


Owner: 

Nunber  of  Colunns: 
Nuaber  of  Rows: 
Table  Type: 

Storage  Structure: 
Row  Width: 
Journaling: 

NewTable  Find  Top  Bottoi  Help  End 


Coluan  Naie 

Data  Fonat 

Key  No. 

catcode 

c3 

catnaae 

c60 

1 — . — -- 

destael 

2 

22 

USER  RELATION 

heap 

63 

Disabled 


Figure  29  Database  Relation  Table 


bibindex” 


VIFREO  -  Forms  Catalog 


Name 

Owner 

authfon 

destael 

ay 

destael 

endforn 

destael 

forn3 

destael 

kw 

destael 

pn 

destael 

pay 

destael 

po 

destael 

pubforn 

destael 

py 

destael 

sub  j 

destael 

titles 

destael 

topfor* 

destael 

viewfora 

destael 

Position  cursor  over  the  name  of  the 
form  you  wish  to  select,  then  use 
the  menu  to  perform  the  appropriate 
operation  on  that  form. 


Create  Destroy  Edit  Rename  Utilities  Find  Top  Bottom  > 


Figure  30  VIFRED  Forms  Catalog  frame 
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VI FRED  -  Save  Fora 


This  fraae  is  used  to  save  the  fora  definition  in  the 
database.  You  should  enter  the  naae  for  the  fora  here. 


Fora  Nane  :  vievfora 


K  QBFNane  with  the  saie  naie  as  the  fora  will  be  created 
for  a  new  fora  created  froa  a  table  or  joindef. 


Save  Forget  Help 


Figure  31 


ViFRED  Form  Save  frame 
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APPENDIX  B 


0  SL.  CODE  SEGMENTS  AND  I  NG  R  E  S _/VJ  FRED  FOR  MS 

DESCR I PT I ONS 

. . . . . . . . . . . . . 

/•  •/ 

/»  Prograa  Nane:  "references"  Date:  16  Deceaber  1986  •  / 

/*  •/ 

/•  Author:  Janes  F.  De  Stael,  LCDR,  USN  »/ 

/•  •/ 

/•  Prepared  in  conjunction  with  Masters  Thesis  at  the  Naval  Postgraduate  School  »/ 
/*  Monterey,  California  93943  •/ 

/«  »/ 

/•  DBMS:  INGRES  Version  4.*  •/ 

/»  Operating  Systen:  UNIX  BSD  4.2  •/ 

/*  Hardware:  VAX  11/785  •/ 

/•  •/ 

/•••••»•••* . . Ml./ 

/>  All  INGRES  foras  descriptions  were  prepared  >/ 

/*  using  INGRES  V IFRED/Uti 1 i ties/Print  */ 

/•  INGRES  fora  description  for  topforn  •/ 


•  ••  We  leone  to  REFERENCES  »»» 

Would  you  like  to  see: 

<T>  A  list  of  Topics  (  subject  list  ) 

<K>  A  list  of  titles  containig  a  Key  word  or  phrase 

(  i.e.  such  as  "DATABASE"  or  "FOURTH  GENERATION  LANGUAGE"  ) 

<A>  A  list  of  titles  based  on  soae  conbination  of  Author  and 
nonth  and/or  year 

<P>  A  list  of  titles  based  on  sone  conbination  of  Publication  and 
aonth  and/or  year 
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Fora  nane:  topforn 
Fora  owner:  at 

Number  of  columns  on  screen:  80 
Nuaber  of  lines  on  screen:  18 
Nuaber  of  fields:  0 
Number  of  tria  strings:  9 
Date  last  modified:  15-dec-86 


FIELD  DESCRIPTIONS 
/»  None  »/ 


/*  File:  topfraae.osl  >/ 

"CursorHelp"  =  { 

helpfile  "Cursor  Control" 

"/work/destael/reference/keyhel p. tx  t* ; 

I 

■MenuHelp*  =  { 

helpfile  "Opening  Frane" 

"/work/destael /reference/ tophelp.txt"; 

I 

•Topics"  =  { 

callfrane  subjfr; 

I 

"Keyword"  =  { 

cal  If  rase  kwfr; 

) 

■Author"  =  { 

cal  If  rase  authfraael 
I 

■Publication"  =  { 

call frane  pubfraae; 

1 

"Report"  =  { 

call frane  endfr; 

) 

■Quit"  =  { 

message  "restoring  database  to  original  condition..." 
sleep  2; 

range  of  d  is  descr ipt2; 
replace  d  (reptout="N") ; 
nessage  "Bye-bye  y f al 1 " » 
sleep  2; 
exit; 

) 


99 
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/•  INGRES  for*  description  for  authfori  •/ 


Authors 

Would  you  like  to  construct  a  list  of  titles  based  on: 

<0>  Author* s  nane  Only 

<Y>  Authors  nane  and  Year  of  publication  of  his/her  article 

<H>  Authors  naae  and  Month  of  publication  of  his/her  article 

<A>  Author* s  naae  and  aonth  and  year  (All)  of  publication  of 
his/her  article 


Note 

When  entering  the  author's  naae  the  syntax  is:  *LASTNAME,F.H. \ 
Initials  are  not  required  but  are  desirable. 

There  should  be  NO  SPACES. 


Fora  naae:  authfora 
Fora  owner:  at 

Nuaber  of  colunns  on  screen:  60 
Nuaber  of  lines  on  screen:  19 
Nuaber  of  fields:  0 
Nuaber  of  trim  strings:  11 
Date  last  aodified:  13-dec-86 


FIELD  DESCRIPTIONS 
/•  None  •/ 
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/»  File:  authfrai.osl  »/ 


'Curs or He  Ip"  =  { 

helpfile  "Cursor  Control* 

"/work/destael/reference/keyhelp. tit"; 

1 

•MenuHelp’  -  { 

helpfile  "Authors-etc  Fraae* 

■/work/destael/reference/authhelp. txt"i 

1 

•Only"  =  ( 

calif  race  aofr; 

1 

•Year*  =  l 

callfraae  ayfr; 

1 

•Month"  *  { 

callfrane  aafr! 

) 

•All"  =  ( 

cal  I fraae  aayfri 

1 

•End'  =  ( 
return; 

) 
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/*  INGRES  fori  description  for  ao  (author  only  fori)  ■/ 


111  Month,  Year,  and  Title  of  Article  Based  On  Author’s  Naie  Only  *■» 
Author: 


♦ . + - f . + 

Ihonth !Year I  Title  1 


Fora  naie:  ao 
Fora  owner:  at 

Nmber  of  coluans  on  screen:  80 
Nuaber  of  lines  on  screen:  22 
Nuiber  of  fields:  2 
Nuaber  of  trii  strings:  i 
Date  last  aodified:  12-dec-86 


FIELD  DESCRIPTIONS 


Field  nane:  authors 
Field  title:  Author: 

Display  foraat:  -C110.55 

Special  display  attributes:  Mandatory  field,  Reverse  video,  Force  upper  case 
Type  of  field:  regular 
Default  value: 

Validation  check: 

Validation  error  aessage: 
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Field  name*.  keytitle 
Type  of  field:  table  field 


Field  name:  month 
Field  title:  Honth 
Display  format:  c3 

Special  display  attributes:  Display  only,  Force  upper  case 
Type  of  field:  column  in  table  fieldcat 
Default  value: 

Validation  check: 

Validation  error  message: 


Field  name:  year 
Field  title:  Year 
Display  format:  i4 

Special  display  attributes:  Display  only 
Type  of  field:  column  in  table  field 
Default  value: 

Validation  check: 

Validation  error  message: 


Field  name:  title 
Field  title:  Title 
Display  format:  cl65 . 55 

Special  display  attributes:  Display  only,  Force  upper  case 
Type  of  field:  column  in  table  field 
Default  value: 

Validation  check: 

Validation  error  message: 
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/•  File:  aofr.osl  (author  only  fraae  osl  aodule)  */ 


■CursorHelp"  =  ( 

helpfile  "Cursor  Control* 

"/work/destael/reference/keyhelp. txt"; 

) 

•MenuHelp*  =  ( 

helpfile  "Author-Only  Fraae* 

"/work/destael/reference/aohelp.  txt"; 

} 

field  authors  =  { 

authors  :=  *•"  ♦  authors  * 
ao.  keytitle  :=  retrieve  (aonth  =  descript2. aonth, 
year  =  descript2.year,  title  -  descri pt2. title) 
where  (descr ipt2. authors  =  authors); 
resuae  field  keytitle; 

) 

"View"  =  { 

callfraae  viewfraae  (title  :=  keytitle. title); 
resuae  field  keytitle; 

} 

"End"  =  ( 
return; 
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/■  INGRES  fora  description  for  an  (author-aonth  forn)  »/ 


■*»  Year  and  Title  Based  On  Author  and  Month  »*■ 


Author: 


Month** 


f - + . . . + 

! Year  I T i 1 1 e  I 


+ - + . + 


Forn  naae:  an 
Forn  owner:  at 

Nuaber  of  colunns  on  screen:  80 
Nunber  of  lines  on  screen:  22 
Nuiber  of  fields:  3 
Nunber  of  trii  strings:  1 
Date  last  aodified:  12-dec-86 
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FIELD  DESCRIPTIONS 


Field  naae:  authors 
Field  title:  Author: 

Display  format:  -cii0.55 

Special  display  attributes:  Mandatory  field,  Reverse  video,  Force  upper  case 
Type  of  field:  regular 
Default  value: 

Validation  check: 

Validation  error  message: 


Field  name:  month 
Field  title:  Month: 

Display  fonat:  c3 

Special  display  attributes:  Mandatory  field,  Reverse  video,  Force  upper  case 
Type  of  field:  regular 
Default  value: 

Validation  check:  month  in  [WJANW, "FEB" , "MAR", WAPRW , "MAY" , "JUN* , " JUL* , "AUG", "S 
EP", "OCT", "NOV", "DEC" ] 

Validation  error  message:  Month  aust  be  standard  3* letter  abbreviation. 


Field  naae:  keytitle 
Type  of  field:  table  field 


Field  naae:  year 
Field  title:  Year 
Display  foraat:  i4 

Special  display  attributes:  Display  only 
Type  of  field:  coluan  in  table  field 
Default  value: 

Validation  check: 

Validation  error  message: 


Field  name:  title 
Field  title:  Title 
Display  format:  ci65.55 

Special  display  attributes:  Display  only,  Force  upper  case 
Type  of  field:  coluan  in  table  field 
Default  value: 

Validation  check: 

Validation  error  message: 


79 


/»  File:  aifr.osl  (author-aonth  frame  osl  module)  »/ 


"CursorHelp"  =  ( 

helpfile  "Cursor  Control" 

"/work/destael/reference/keyhelp.txt"; 

) 

"MenuHelp"  =  { 

helpfile  "Author-Month  Fraae* 

"/vork/destael/reference/aahelp. txt"; 

) 

field  "authors"  =  { 

authors  :=  +  authors  * 

resume  field  month; 

1 

field  "aonth"  2  ( 

aa.keytitle  :=  retrieve  (year  2  descript2.year, 
title  =  descript2. title) 
where  (descript2. authors  =  authors 
and  descript2. month  2  aonth); 
resume  field  key tit  I e ; 

1 

"View"  2  ( 

cal  If  rase  viewfraae  (title  :=  keytitle. title); 
resume  field  keytitle; 

1 

"End"  =  ( 
return) 

1 

"CursorHelp"  2  ( 

helpfile  "Cursor  Control" 

"/work/destael/reference/keyhelp. txt"; 

1 

"MenuHelp"  2  { 

helpfile  "Author-Month-Year  Frame" 

"/work/destael /ref erence/aayhel p. txt" ; 

1 

field  "authors"  2  ( 

authors  :=  "•"  ♦  authors  * 
resume  field  aonth; 

) 

field  "aonth"  2  { 

resume  field  year; 

) 

field  "year"  2  ( 

aay. keytitle  :=  retrieve  (title  2  descript2. title) 
where  (descri pt2. authors  2  authors 
and  descript2. month  2  aonth 
and  descript2.year  2  year); 
resuie  field  keytitle; 


80 


"View"  =  ( 

callfraae  viewfraae  (title  *•  keytit le. title) ; 
resuae  field  keytit le ; 

) 

"End"  =  ( 
return; 

) 
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/•  INGRES  fori  description  for  ay  (author-year  fori)  »/ 


•••  Month  and  Title  Based  On  Author  and  Year  ••• 


Author: 


Year: 


♦ . ♦ . { 

! HonthITi t le  ! 


+ . ♦ . - . I 


Fora  naie:  ay 
Fora  owner:  at 

Nuiber  of  coluans  on  screen:  80 
Nuaber  of  lines  on  screen:  38 
Nuiber  of  fields:  3 
Nuaber  of  trii  strings:  1 
Date  last  lodified:  13-dec-86 
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FIELD  DESCRIPTIONS 


Field  name:  authors 
Field  title:  Author: 

Display  fomat:  -cl  10. 55 

Special  display  attributes:  Mandatory  field,  Reverse  video,  Force  upper  case 
Type  of  field:  regular 
Default  value: 

Validation  check: 

Validation  error  aessage: 


Field  naae:  year 
Field  title:  Year: 

Display  foriat:  -i4 

Special  display  attributes:  Mandatory  field,  Reverse  video 
Type  of  field:  regular 
Default  value: 

Validation  check:  year  >-  1800  and  year  <=  2200 

Validation  error  aessage:  Year  must  be  4-digit  format  between  1800  &  2200 


Field  name:  keytitle 
Type  of  field:  table  field 


Field  name:  month 
Field  title:  Month 
Display  foriat:  c3 

Special  display  attributes:  Display  only,  Force  upper  case 
Type  of  field:  coluan  in  table  field 
Default  value: 

Validation  check: 

Validation  error  message: 


Field  name:  title 
Field  title:  Title 
Display  format:  cl65. 55 

Special  display  attributes:  Display  only,  Force  upper  case 
Type  of  field:  coluan  in  table  field 
Default  value: 

Validation  check: 

Validation  error  aessage: 
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/»  File:  ayfr.osl  (author-year  frame  osl  module)  */ 


■CursorHelp"  =  ( 

helpfile  "Cursor  Control" 

"/vork/destael/reference/keyhelp. txt"; 

) 

•MenuHelp"  =  { 

helpfile  "Author-Year  Frame" 

"/vork/destael/reference/ayhelp.  txt"; 

) 

field  "authors"  =  ( 

authors  :=  +  authors  ♦  "»■; 

resume  field  year; 

) 

field  "year"  =  { 

ay. keytitle  :=  retrieve  (month  =  descript2. month, 
title  =  descript2. title) 
where  (descript2. authors  =  authors 
and  descript2.year  =  year); 
resume  field  keytitle; 

1 

"View"  *  ( 

callframe  viewfraae  (title  :=  keytitle. title); 
resume  field  keytitle; 

■) 

"End"  =  ( 
return; 

1 
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/»  INGRES  fora  description  for  as  (author-aonth-year  fora)  •/ 


•»*  Titles  Based  On  Author,  Month,  and  Year  *■* 


Author:  Month: 

Year: 


Font  naae:  any 
Fora  owner:  at 

Nuiber  of  columns  on  screen:  8f 
Nuiber  of  lines  on  screen:  23 
Number  of  fields:  4 
Nuiber  of  tria  strings:  1 
Date  last  aodified:  13-dec-86 


FIELD  DESCRIPTIONS 


Field  naae:  authors 
Field  title:  Author: 

Display  foraat:  -cll0.55 

Special  display  attributes:  Mandatory  field,  Reverse  video,  Force  upper  case 
Type  of  field:  regular 
Default  value: 

Validation  check: 

Validation  error  message: 
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Field  name:  »onth 
Field  title*.  Month: 

Display  format:  c3 

Special  display  attributes:  Mandatory  field,  Reverse  video,  Force  upper  case 
Type  of  field:  regular 
Default  value: 

Validation  check:  Bonth  in  ( WJAN«, "FEBn, "MAR", "APR" , "MAY* , nJUN* , nJUL«, "AUGW, "S 
EP", "OCT", "NOV", "DEC"] 

Validation  error  message:  Month  must  be  standard  3- letter  abbreviation. 


Field  naae:  year 
Field  title:  Year: 

Display  foriat:  -i4 

Special  display  attributes:  Mandatory  field,  Reverse  video 
Type  of  field:  regular 
Default  value: 

Validation  check:  year  >=  1800  and  year  <=  2200 

Validation  error  Message:  Year  must  be  4-digit  format  between  1800  and  2200 


Field  naae:  keytitle 
Type  of  field:  table  field 


Field  naae:  title 
Field  title:  Title 
Display  foraat:  cl65. 55 

Special  display  attributes:  Display  only,  Force  upper  case 
Type  of  field:  column  in  table  field 
Default  value: 

Validation  check: 

Validation  error  message: 
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/*  File**  amyfr.osl  (author-ionth-year  frame  osl  module)  */ 


■CursorHelp"  =  { 

helpfile  "Cursor  Control* 

"/work/destael/reference/keyhelp.txt"; 

) 

"MenuHelp"  =  { 

helpfile  "Author-Honth-Year  Fraae" 

"/wor k/des tael /ref erence/amyhelp. tx t* ; 

1 

field  "authors"  =  { 

authors  :=  +  authors  «•  "»"» 

resume  field  month; 

) 

field  "month"  =  t 

resume  field  year; 

1 

field  "year*  =  [ 

amy. keytitle  :=  retrieve  (title  =  descr ipt2. title) 
where  (descript2. authors  =  authors 
and  descr i pt2. month  =  month 
and  descript2.year  =  year); 
resume  field  keytitle; 

) 

■View"  =  l 

callfraae  viewframe  (title  :=  keytitle. title); 
resume  field  keytitle; 

1 

"End"  =  ( 
return; 


87 


/*  INGRES  fori  description  for  kw  (key  word  fora)  •/ 


■■■  Listing  of  Titles  Containing  a  Key  Word  or  Phrase 
Word/Phrase: 


+ . ♦ - 1- . t 

IMonth I  Year ! Ti tl e  I 


f . + - + . . 4- 


Fora  naae:  kw 
Form  owner:  at 

Nuiber  of  coluans  on  screen:  80 
Nuaber  of  lines  on  screen:  22 
Muiber  of  fields:  2 
Number  of  trii  strings:  l 
Date  last  aodified:  15-dec-86 


FIELD  DESCRIPTIONS 


Field  name:  title 
Field  title:  Uord/Phrase: 

Display  foraat:  -cl65, 55 

Special  display  attributes:  Mandatory  field,  Reverse  video,  Force  upper  case 
Type  of  field:  regular 
Default  value:  * 

Validation  check: 

Validation  error  message: 
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Field  name:  keytitle 
Type  of  field:  table  field 


Field  name:  month 
Field  title:  Month 
Display  format:  c3 

Special  display  attributes:  Display  only,  Force  upper  case 
Type  of  field:  column  in  table  field 
Default  value: 

Validation  check: 

Validation  error  message: 


Field  name:  year 
Field  title:  Year 
Display  format:  i4 

Special  display  attributes:  Display  only 
Type  of  field:  column  in  table  field 
Default  value: 

Validation  check: 

Validation  error  message: 


Field  name:  title 
Field  title:  Title 
Display  format:  C165.55 

Special  display  attributes:  Display  only,  Force  upper  case 
Type  of  field:  column  in  table  field 
Default  value: 

Validation  check: 

Validation  error  message: 
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/»  File:  kwfr.osl  (key  word  fraae  osl  aodule)  »/ 

"CursorHelp"  -  ( 

helpfile  "Cursor  Control" 

"/work/destael/reference/keyhelp. txt"; 

) 

"MenuHelp"  2  ( 

helpfile  "Key  Word  Frame" 

"/work/destael/reference/kwhelp.txt"; 

) 

field  "keyword"  2  { 

keyword  :=  +  keyword  * 

kw. keytitle  :=  retrieve  (month  2  descript2. month, 
year  2  descript2.year,  title  2  descr ipt2. title) 
where  (descr ipt2. title  2  keyword); 
resume  field  keytitle; 

} 

"View"  2  i 

callframe  viewfraae  (title  :=  keytitle. title); 
resuae  field  keytitle; 

) 

"End"  2  ( 
return; 
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/»  INGRES  forn  description  for  subj  (topics  (subject  list)  fora)  »/ 


Subject  List 


+ . + . . — 

CatcodelCategory  Naae 


Forn  naae:  subj 
Forn  owner:  at 

Nuiber  of  colunns  on  screen:  80 
Nunber  of  lines  on  screen:  26 
Nuiber  of  fields:  1 
Number  of  tria  strings:  1 
Date  last  aodified:  14-dec-86 
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FIELD  DESCRIPTIONS 


Field  name:  subjlist 
Type  of  field:  table  field 


Field  naae:  catcode 
Field  title:  Catcode 
Display  format:  c3 

Special  display  attributes:  Display  only,  Force  upper  case 
Type  of  field:  coluan  in  table  field 
Default  value: 

Validation  check: 

Validation  error  aessage: 


Field  name:  catnaae 
Field  title:  Category  Naae 
Display  foraat:  c60 

Special  display  attributes:  Display  only,  Force  upper  case 
Type  of  field:  column  in  table  field 
Default  value: 

Validation  check: 

Validation  error  aessage: 


/*  File:  subjfr.osl  (topics  (subject  list)  fraae  osl  aodule)  •/ 


initialize  =  { 

subj. subjlist  :=  retrieve  (catcode  =  bibindex. catcode, 
catnaae  -  bibindex. catnaae) i 
resuae  field  subjlist; 

) 

"CursorHelp"  2  ( 

helpfile  "Cursor  Control* 

■/work/destael/reference/keyhelp. txt"; 

} 

■MenuHelp*  2  ( 

helpfile  "Subject  List  Fraae1 

"/work/destael/reference/subjhelp. txt"; 

) 

■Titles"  =  ( 

callfraae  titlefr  (catcode  :=  subj list. catcode; 
catnaae  :=  subj list. catnaae) ; 

) 

■End1  2  { 


return; 

) 


92 


/•  INGRES  foro  description  for  titles  ( ti t I es -by-category  form)  •/ 


Category  Code: 


Category: 


+ - - - 

!  Titles 


+ 


Fora  naae:  titles 
Fora  owner:  at 

Nimber  of  coluans  on  screen:  80 
Nuiber  of  lines  on  screen:  33 
Nuaber  of  fields:  3 
Nuiber  of  trim  strings:  0 
Date  last  modified :  M-dec-86 
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FIELD  DESCRIPTIONS 


Field  naae:  titlelist 
Type  of  field:  table  field 


Field  naae:  title 

Field  title:  Titles 

Display  foraat:  ci65. 55 

Special  display  attributes:  Display  only,  Force  upper  case 
Type  of  field:  colunn  in  table  field 
Default  value: 

Validation  check: 

Validation  error  aessage: 


Field  naae:  catcode 
Field  title:  Category  Code: 

Display  foraat:  c3 

Special  display  attributes:  Display  only,  Force  upper  case 
Type  of  field:  regular 
Default  value: 

Validation  check: 

Validation  error  aessage: 


Field  naae:  catnaae 
Field  title:  Category: 

Display  foraat:  c60 

Special  display  attributes:  Display  only,  Force  upper  case 
Type  of  field:  regular 
Default  value: 

Validation  check: 

Validation  error  aessage: 
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/*  File:  titlfr.osl  (titles-by-category  frame  osl  nodule)  »/ 


initialize  -  { 

titles. titlelist  :=  retrieve  (title  =  descr ipt2. title) 
where  (descript2.catcode  =  catcode); 
resume  field  titlelist; 

) 

•CursorHelp"  =  { 

helpfile  "Cursor  Control* 

"/vork/destael/reference/keyhelp. txt"; 

) 

•MenuHelp"  =  { 

helpfile  "Titles  Fraie1 

"/work/des tael /ref erence/titl help,  txt"; 

) 

•View"  =  { 

callframe  viewfraae  (title  :=  titlelist. title); 
resume  field  titlelist; 

) 

"End*  =  { 
return; 

1 
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/»  INGRES  fon  description  for  pubforn  (selection-by-publication  naae  fori)  •/ 


»»»  Publications  »»» 

Would  you  like  to  construct  a  list  of  titles  based  on? 

<P>  Publications  nane  only 

<Y>  Publication's  na*e  and  Year  of  publication 

<H>  Publication's  naae  and  Month  of  publication 

<A>  Publication's  naae  and  aonth  and  year  of  publication  ( <A> 1 1 ) 

in 

NOTE:  Put  only  single  spaces  between  words  in  publication  naanes. 


Fora  naae*.  pubforn 
Fora  owner:  at 

Nuaber  of  coluans  on  screen:  80 
Nuaber  of  lines  on  screen:  20 
Nuaber  of  fields:  0 
Nuaber  of  trial  strings:  8 
Date  last  aodified:  15-dec-86 


FIELD  DESCRIPTIONS 
/»  None  »/ 
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/■  Files  pubfr.osl  (publications  selection  fraae  osl  aodule)  *1 


■CursorHelp"  =  ( 

helpfile  "Cursor  Control* 

"/vork/destael/reference/keyhelp. txt"; 

) 

•MenuHeip"  =  { 

helpfile  "Publication-etc  Fraie* 

"/work/destaei/reference/pubhelp. txt"; 

) 

•PubNaue"  =  I 

cal  If  race  pofr; 

) 

"Year"  =  i 

cal  If  rase  pyfr; 

} 

•Month"  =  l 

callfrane  P*f  r ; 

} 

"Air  =  1 

callfrane  payfrl 

) 

•End*  :  1 
return; 

1 
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/•  INGRES  for*  description  for  po  (publication  naae  only  fora)  »/ 


■««  Month,  Year,  and  Title  of  Article  Based  On  Publication  Naae  Only 
Publication: 


f . ♦ - . - . - . t 

IMonth !  Year  i  Ti  1 1  e 


♦ . + - 1 . . ♦ 


Fora  naae:  po 
Fora  owner:  at 

Nuiber  of  coluans  on  screen:  80 
Nuaber  of  lines  on  screen:  22 
Nuaber  of  fields:  2 
Nuaber  of  tria  strings:  1 
Date  last  aodified:  15-dec-86 


FIELD  DESCRIPTIONS 


Field  naae:  publication 
Field  title:  Publication: 

Display  foraat:  -cl!0.55 

Special  display  attributes:  Mandatory  field,  Reverse  video,  Force  upper  case 
Type  of  field:  regular 
Default  value: 

Validation  check: 

Validation  error  message: 
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Field  naae:  keytitle 
Type  of  field:  table  field 


Field  naae:  sonth 
Field  title:  Month 
Display  foraat:  c3 

Special  display  attributes:  Display  only,  Force  upper  case 
Type  of  field:  coluan  in  table  field 
Default  value: 

Validation  check: 

Validation  error  message: 


Field  naae:  year 
Field  title:  Year 
Display  format:  i4 

Special  display  attributes:  Display  only 
Type  of  field:  coluan  in  table  field 
Default  value: 

Validation  check: 

Validation  error  message: 


Field  naae:  title 
Field  title:  Title 
Display  foraat:  cl65.55 

Special  display  attributes:  Display  only,  Force  upper  case 
Type  of  field:  coluan  in  table  field 
Default  value: 

Validation  check: 

Validation  error  message: 
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/•  File:  pofr.osl  (publication  naie  only  fraie  osl  aodule)  */ 

"CursorHelp"  =  1 

helpfile  "Cursor  Control* 

"/vork/destael/reference/keyhelp. txt"; 

) 

"MenuHelp"  =  ( 

helpfile  "Publication-Only  Fraae" 

"/vork/destael/reference/pohelp. txt" ; 

1 

field  "publication"  =  ( 

po. keytitle  :=  retrieve  (aonth  =  descript2.aonth, 
year  =  descript2.year,  title  =  descript2. title) 
where  (descr ipt2. publication  =  publication); 
resuae  field  key ti tie; 

) 

"View"  =  l 

callfraae  vievfraae  (title  :=  keytitle. title) ; 
resuae  field  keytitle; 

} 

"End"  =  i 
return; 
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/*  INGRES  fori  description  for  pa  (publication  naae  and  aonth  fora)  »/ 


111  Year  and  Title  Based  On  Publication  Naae  and  Month  *** 
Publication: 

Month: 


* - ♦ . + 

1 YearlTitle  1 


+ - + . + 


Fora  naie:  pa 
Fora  owner:  at 

Nuaber  of  coluans  on  screen:  81 
Nuaber  of  lines  on  screen:  23 
Nuaber  of  fields:  3 
Nuaber  of  trim  strings:  1 
Date  last  aodified:  15-dec-86 


FIELD  DESCRIPTIONS 


Field  naae:  publication 
Field  title:  Publication: 

Display  foraat:  -cil0.55 

Special  display  attributes:  Mandatory  field,  Reverse  video,  Force  upper  case 
Type  of  field:  regular 
Default  value: 

Validation  check: 

Validation  error  aessage: 
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Field  name:  nonth 
Field  title:  Month: 

Display  format:  c3 

Special  display  attributes:  Mandatory  field,  Reverse  video,  Force  upper  case 
Type  of  field:  regular 
Default  value: 

Validation  check:  nonth  in  [BJAN",nFEBn,BMARw,"APR\nMAYtf,,JUN*,"JUL,,nAUGw,BS 
EPVOCTVNQVVDECBJ 

Validation  error  message:  Month  must  be  standard  3-letter  abbreviation. 


Field  name:  keytitle 
Type  of  f ieid:  table  field 


Field  name:  year 
Field  title:  Year 
Display  format:  i4 

Special  display  attributes:  Display  only 
Type  of  field:  column  in  table  field 
Default  value: 

Validation  check: 

Validation  error  message: 


Field  naae:  title 
Field  title:  Title 
Display  fornat:  C165.55 

Special  display  attributes:  Display  only,  Force  upper  case 
Type  of  field:  column  in  table  field 
Default  value: 

Validation  check: 

Validation  error  message: 
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/'  File:  pifr.osl  (publication  naie  and  oonth  frame  osl  aodule)  »/ 


•CursorHelp"  =  { 

helpfile  "Cursor  Control" 

f/work/destael/reference/keyhelp. txt"; 

} 

■MenuHelp"  =  { 

helpfile  "Publication-Month  Fraae" 

"/work/destael/reference/pahelp. txt"; 

} 

field  "publication"  =  { 
resuae  field  lonth; 

) 

field  "aonth"  =  ( 

pa. keytitle  :=  retrieve  (year  =  descript2.year, 
title  =  descr ipt2. title) 

where  (descr ipt2. publication  =  publication 
and  descr ipt2. nonth  =  aonth); 

resuae  field  keytitle; 

) 

"View"  =  { 

callfraae  viewfraae  (title  :=  keytitle. title) ; 
resuae  field  keytitle; 

) 

"End"  =  { 
return; 

} 

"CursorHelp"  =  ( 

helpfile  "Cursor  Control" 

"/vork/destael/reference/keyhelp.  txt"; 

) 

"MenuHelp"  =  { 

helpfile  "Publication-Month-Year  Fraae" 
"/work/destael /ref erence/payhel p. txt" ; 

) 

field  "publication"  =  { 
resume  field  aonth; 

I 

field  "month"  =  ( 

resume  field  year; 

) 

field  "year"  =  { 

pay. keytitle  :=  retrieve  (title  =  descr ipt2. title) 
where  (descript2.publ ication  =  publication 
and  descript2. month  =  aonth 
and  descr ipt2. year  =  year); 
resume  field  keytitle; 
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■View”  =  { 

cal  If  rase  viewfrane  (title  :=  keytitle. title) ; 
resuie  field  keytitle; 

) 

"End"  =  i 
return; 

) 
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/»  INGRES  form  description  for  py  (publication  name  and  year  fora)  »/ 


»»•  Month  and  Title  Based  On  Publication  and  Year  ••• 


Publication: 

Year: 


+ . ♦ . . . + 

1  Month  '.Title 


+ . + . ♦ 


Fora  naae:  py 
Fora  owner:  at 

Nuaber  of  coluans  on  screen:  8fl 
Nuiber  of  lines  on  screen:  37 
Nuaber  of  fields:  3 
Nuiber  of  trim  strings:  l 
Date  last  aodified:  15-dec-86 
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FIELD  DESCRIPTIONS 


Field  naae:  publication 
Field  title:  Publication: 

Display  format:  -cl  10. 55 

Special  display  attributes:  Mandatory  field,  Reverse  video,  Force  upper  case 
Type  of  field:  regular 
Default  value: 

Validation  check: 

Validation  error  message*. 


Field  naae*.  year 
Field  title:  Year*. 

Display  foraat:  -i4 

Special  display  attributes:  Mandatory  field,  Reverse  video 
Type  of  field:  regular 
Default  value: 

Validation  check:  year  >=  1800  and  year  <=  2200 

Validation  error  aessage:  Year  oust  be  4-digit  foraat  between  1800  &  2200 


Field  naae*.  keytitle 
Type  of  field:  table  field 


Field  naae:  aonth 
Field  title:  Month 
Display  foraat:  c3 

Special  display  attributes*.  Display  only,  Force  upper  case 
Type  of  field:  coluan  in  table  field 
Default  value: 

Validation  check: 

Validation  error  message: 


Field  name*,  title 
Field  title:  Title 
Display  format:  cl65 . 55 

Special  display  attributes*.  Display  only,  Force  upper  case 
Type  of  field*,  coluan  in  table  field 
Default  value*. 

Validation  check*. 

Validation  error  message: 
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/»  File:  pyfr.osl  (publication  name  and  year  frame  osl  module)  »/ 

"CursorHelp"  =  ( 

helpfile  "Cursor  Control* 

"/work/destael/reference/keyhelp. txt"; 

1 

"MenuHelp"  =  ( 

helpfile  "Publication-Year  Frame" 

"/vork/destael/reference/pyhelp. txt*; 

1 

field  "publication"  =  l 
resume  field  year; 

) 

field  "year"  =  I 

py, keyti t le  :=  retrieve  (month  =  descr ipt2. month, 
title  =  descript2. title) 
where  (descript2. publ ication  =  publication 
and  descript2.year  =  year); 
resume  field  keytitle; 

) 

"View"  =  ( 

cal  If  rame  viewfrane  (title  :  =  keytitle. title); 
resume  field  keytitle; 

) 

"End"  =  [ 
return; 
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/»  INGRES  for®  description  for  pay  (publication  naie  and  lonth  and  year  fori)  »/ 

!  Month:  •••  Titles  Based  On  Publication,  Month,  and  Year  Year: 

1  Publication: 


Forn  naie:  pay 
Fora  owner:  at 

Nuiber  of  coluans  on  screen:  80 
Nuaber  of  lines  on  screen:  22 
Nuiber  of  fields:  4 
Nuaber  of  trii  strings:  1 
Date  last  lodified:  15-dec-86 


FIELD  DESCRIPTIONS 


Field  naae:  publication 
Field  title:  Publication: 

Display  foraat:  -cll0.55 

Special  display  attributes:  Mandatory  field,  Reverse  video,  Force  upper  case 
Type  of  field:  regular 
Default  value: 

Validation  check: 

Validation  error  aessage: 
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Field  name:  month 
Field  title:  Month: 

Display  format:  c3 

Special  display  attributes:  Mandatory  field,  Reverse  video,  Force  upper  case 
Type  of  field:  regular 
Default  value: 

Validation  check:  month  in  i,,JAN","FEB",BMAfin,"APR-,"HAY",,,JUNB,,,JUL",>AUG",wS 
EPVOCTVNOVVDECt] 

Validation  error  message:  Month  lust  be  standard  3-letter  abbreviation. 


Field  name:  year 
Field  title:  Year: 

Display  format:  -i4 

Special  display  attributes*.  Mandatory  field,  Reverse  video 
Type  of  field:  regular 
Default  value: 

Validation  check:  year  >s  1800  and  year  <=  2200 

Validation  error  message:  Year  must  be  4-digit  format  between  1800  and  2200 


Field  name:  keytitle 
Type  of  field:  table  field 


Field  name*,  title 
Field  title:  Title 
Display  format:  cl65. 55 

Special  display  attributes:  Display  only,  Force  upper  case 
Type  of  field:  column  in  table  field 
Default  value: 

Validation  check: 

Validation  error  message: 
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/*  File:  pmyfr.osl  (publication  name  and  month  and  year  fraie  osl  Module)  »/ 


•CursorHelp"  =  I 

helpfile  "Cursor  Control1 

Vwork/destael/reference/keyhelp.tit"; 

) 

'MenuHelp*  =  ( 

helpfile  "Publication-Month-Year  Frame" 

"/work/des tael /ref erence/payhel p.  txt" ; 

} 

field  "publication"  -  { 
resume  field  lonth; 

) 

field  "month"  -  ( 

resume  field  year; 

) 

field  "year"  =  l 

pay.keytitle  :=  retrieve  (title  =  descr ipt2. title) 
where  (descript2. publication  -  publication 
and  descr ipt2. month  *  month 
and  descript2.year  =  year); 
resume  field  keyti tie; 

) 

"View"  •  f 

callframe  vievfrane  (title  :=  keytitle. title); 
resume  field  keytitle; 

) 

"End"  *  f 
return; 

} 
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/»  INGRES  fora  description  for  viewform  (view  the  current  title)  »/ 


Press  (CTRL)  F  to  view  bottoi  of  page. 
Nonth:  Article  Description 

Title: 


Authors: 


Publication: 


Abstract: 


Forn  nane:  viewfora 
Fora  owner:  at 

Nusber  of  coluans  on  screen*.  80 
Nuiber  of  lines  on  screen:  39 
Nufflber  of  fields:  6 
Huiber  of  trim  strings:  2 
Date  last  aodified:  i3-dec-86 


Year: 
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FIELD  DESCRIPTIONS 


Field  name:  month 
Field  title:  Month** 

Display  format:  c3 
Special  display  attributes: 
Type  of  field:  regular 
Default  value: 

Validation  check: 

Validation  error  message: 


Display  only,  Force  upper  case 


Field  name:  year 
Field  title:  Year: 

Display  format:  -i4 

Special  display  attributes:  Display  only 
Type  of  field:  regular 
Default  value: 

Validation  check: 

Validation  error  message: 


Field  name:  title 
Field  title:  Title: 

Display  format:  -ci65.55 

Special  display  attributes**  Display  only,  Force  upper  case 
Type  of  field:  regular 
Default  value: 

Validation  check: 

Validation  error  message: 


Field  name:  authors 
Field  title:  Authors: 

Display  format:  -cil0.55 

Special  display  attributes:  Display  only,  Force  upper  case 
Type  of  field:  regular 
Default  value: 

Validation  check: 

Validation  error  message: 
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Field  naie*.  publication 
Field  title*.  Publication: 

Display  foraat:  -cil0.55 

Special  display  attributes:  Display  only,  Force  upper  case 
Type  of  field:  regular 
Default  value: 

Validation  check: 

Validation  error  message: 

Field  name:  synop 
Field  title:  Abstract: 

Display  format:  cl500.72 
Special  display  attributes:  Display  only 
Type  of  field:  regular 
Default  value: 

Validation  check: 

Validation  error  message: 


I*  File:  viewfraae.osl  (view  the  current  title  fraie  osl  module)  */ 
initialize  =  { 

viewfora  :=  retrieve  (  authors  -  descr ipt2. authors, 
aonth  -  descr ipt2. month,  year  =  descript2.year , 
publication  =  descr ipt2. publication,  synop  =  descr ipt2. synop  ) 
where  (  descript2. title  =  title  ); 

1 

•CursorHelp"  =  ( 

helpfile  "Cursor  Control* 

"/vork/destael/reference/keyhelp.  txt"; 

) 

■HenuHelp*  =  { 

helpfile  "View  Fraae" 

•/work/destael/reference/viewhelp.  txt"; 

} 

■Save"  =  ( 

replace  descr ipt2  (reptout  -  "Y")  where  descr ipt2. title  =  title; 

■essage  "Entry  marked  for  inclusion  in  bibliography  report  file"; 
sleep  2; 

1 

■UnSave"  =  ( 

replace  descr ipt2  (reptout  =  "N")  where  descr ipt2. title  =  title; 

■essage  "Entry  UNiarked...wil 1  NOT  appear  in  bibliography  report  file"; 
sleep  2; 

} 

■End*  =  { 
return; 

) 
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/*  INGRES  for»  description  for  endform  (closing  screen  (after  report  generation)  fora)  •/ 


FINAL  SCREEN 

REPORT  GENERATION  COMPLETE 


Your  report  is  now  in  your  directory 
in  a  file  named  "bibliography. report" 


Press  <RETURN>  to  continue*. 


Form  name:  endforn 
Form  owner:  at 

Nuaber  of  columns  on  screen:  8fif 
Nuaber  of  lines  on  screen:  19 
Number  of  fields:  1 
Nuaber  of  trim  strings*.  5 
Date  last  aodified:  16*dec-06 


FIELD  DESCRIPTIONS 


Field  name:  leave 
Field  title:  to  continue: 

Display  foraat:  -cl 

Special  display  attributes:  No  echo 

Type  of  field:  regular 

Default  value:  x 

Validation  check: 

Validation  error  message: 
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/•  File:  endfr.osl  (closing  fraae  (after  report  generation)  osl  nodule)  »/ 


initialize  =  ( 

■essage  "Generating  your  report..."; 
sleep  3; 

nessage  "Press  return  when  prompted  to  do  so..."; 
sleep  3; 

call  "report"  ("flags"  -  "-s",  "file"  r  "bibliography. report", 
"report"  =  "bibliography",  "paras"  =  "reptout^Y"); 
range  of  d  is  descr ipt2; 
replace  d  (reptout="N") ; 
resume  field  leave; 

) 

field  "leave"  =  { 
exit; 
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/»  INGRES  fora  description  for  for»3  (relation  "descript2i  data  entry  fora)  •/ 


Article  Description 

Title- 


Authors: 

Publication: 


Voluae: 

Nuaber: 

Month : 

Year: 

Pages: 

ReptOut  (Y/N): 

Catcode : 

Key: 

Abstract: 


Fora  naae:  fora3 
Fora  owner:  at 

Nuiber  of  coluans  on  screen:  80 
Nuaber  of  lines  on  screen:  40 
Nuiber  of  fields:  12 
Nuaber  of  trii  strings:  1 
Date  last  lodified:  12-dec-86 
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FIELD  DESCRIPTIONS 


Field  naae:  key 
Field  title:  Key: 

Display  foraat:  c7 

Special  display  attributes:  Force  upper  case 
Type  of  field:  regular 
Default  value: 

Validation  check: 

Validation  error  aessage: 


Field  naae:  authors 
Field  title:  Authors: 

Display  foraat:  -cl 10* 55 

Special  display  attributes:  Force  upper  case 

Type  of  field:  regular 

Default  value: 

Validation  check: 

Validation  error  aessage: 


Field  naae:  title 
Field  title:  Title: 

Display  foraat:  -C165.55 

Special  display  attributes:  Force  upper  case 

Type  of  field:  regular 

Default  value: 

Validation  check: 

Validation  error  aessage: 


Field  naae:  publication 
Field  title:  Publication: 

Display  foraat:  -cll0.55 

Special  display  attributes:  Force  upper  case 

Type  of  field:  regular 

Default  value: 

Validation  check: 

Validation  error  aessage: 
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Field  name:  volute 
Field  title:  Volute: 

Display  format:  f6 
Special  display  attributes:  None 
Type  of  field:  regular 
Default  value: 

Validation  check: 

Validation  error  message: 


Field  nate:  nutber 
Field  title:  Nutber: 

Display  format:  f6 
Special  display  attributes:  None 
Type  of  field:  regular 
Default  value: 

Validation  check: 

Validation  error  tessage: 


Field  name:  month 
Field  title:  Month: 

Display  format:  c3 

Special  display  attributes:  Force  upper  case 
Type  of  field:  regular 
Default  value: 

Validation  check: 

Validation  error  message: 


Field  nate:  year 
Field  title:  Year: 

Display  format:  f8 
Special  display  attributes:  None 
Type  of  field:  regular 
Default  value: 

Validation  check: 

Validation  error  message: 


Field  name:  pages 
Field  title:  Pages: 

Display  format:  c9 
Special  display  attributes:  None 
Type  of  field:  regular 
Default  value: 

Validation  check: 

Validation  error  message: 
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Field  name:  synop 
Field  title:  Abstract: 

Display  format:  cl500 . 72 
Special  display  attributes:  None 
Type  of  field:  regular 
Default  value: 

Validation  check: 

Validation  error  message: 


Field  name:  catcode 
Field  title:  Catcode: 

Display  format:  c3 

Special  display  attributes:  Force  upper  case 
Type  of  field:  regular 
Default  value: 

Validation  check: 

Validation  error  message: 


Field  name:  reptout 
Field  title:  ReptOut  (Y/N): 

Display  format:  -cl 

Special  display  attributes:  Reverse  video,  Force  upper  case 
Type  of  field:  regular 
Default  value:  N 

Validation  check:  reptout  in  ["Y’Vy’VNVn"! 

Validation  error  message:  This  field  must  be  either  "Y*  or  "N" 
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